程序包 com.apiworks.astro

类 AstroCloudClient

java.lang.Object

com.apiworks.astro.AstroCloudClient

所有已实现的接口:

AutoCloseable

public class AstroCloudClient
extends Object
implements AutoCloseable

Java 版 ApiWorks 星盘 API 客户端（同步）。

封装了星盘服务的所有 HTTP 接口：

• 所有请求都会携带头部 X-App-Id、X-App-Key
• 基础网关默认为 DEFAULT_BASE_URL
• 所有方法返回 ApiResp<T>，其中 code=0 表示成功

主要能力：

• chart：全部 /chart/* 端点，如本命盘、行运盘、三限、次限等
• sign：/mySign、/signs、/signs/{id}、/signs/{id}/compat
• scope：日/周/月/年运势 /scope/day|week|month|year
• event：行运事件 /event/transit
• bazi：八字命盘/流盘/合盘/总结 /bazi/natal|flow|match|summary
• ziwei：紫微命盘/运限/解读 /ziwei/natal|chart|detail
• naks：星宿关系 /naks/relations
• report：桃花/周运/年运/合盘/财运报告 /report/*

需要的请求/响应模型可在 com.apiworks.astro.model.requests.*、 com.apiworks.astro.model.responses.* 包中按需扩展。

使用完毕后可调用 close() 关闭内部线程池，避免进程退出时出现线程未结束的 warning （例如通过 mvn exec:java 运行示例时）。长期运行的应用可复用同一客户端，不必每次关闭。

字段概要

字段

修饰符和类型	字段	说明
static final String	DEFAULT_BASE_URL

构造器概要

构造器

构造器	说明
AstroCloudClient(String appId, String appKey)
AstroCloudClient(String appId, String appKey, String baseUrl, long timeoutMillis)

方法概要

修饰符和类型	方法	说明
ApiResp<BaziFlowVO>	baziFlow(BaziFlowQry qry)	POST /bazi/flow - 八字流盘（带目标日期）。
ApiResp<BaziMatchVO>	baziMatch(BaziMatchQry qry)	POST /bazi/match - 八字合盘（两个人）。
ApiResp<BaziNatalVO>	baziNatal(BaziNatalQry qry)	POST /bazi/natal - 八字命盘。
ApiResp<BaziSummaryVO>	baziSummary(BaziNatalQry qry)	POST /bazi/summary - 八字总结。
ApiResp<AstroDataVo>	chartComparison(DoublePointQry qry)	POST /chart/comparison - 比较盘。
ApiResp<AstroDataVo>	chartComposeSecLimit(DpTransitDateQry qry)	POST /chart/composeSecLimit - 组合次限盘。
ApiResp<AstroDataVo>	chartComposeTripleLimit(DpTransitDateQry qry)	POST /chart/composeTripleLimit - 组合三限盘。
ApiResp<AstroDataVo>	chartComposite(DoublePointQry qry)	POST /chart/composite - 组合盘。
ApiResp<AstroDataVo>	chartCurrent(SinglePointQry qry)	POST /chart/current - 当前天象盘。
ApiResp<AstroDataVo>	chartFirdaria(SpTransitDateQry qry)	POST /chart/firdaria - 法达盘（Firdaria）。
ApiResp<AstroDataVo>	chartLunarReturn(DoublePointQry qry)	POST /chart/lunarReturn - 月回归盘。
ApiResp<AstroDataVo>	chartMarks(DoublePointQry qry)	POST /chart/marks - Marks（马科）盘。
ApiResp<AstroDataVo>	chartMarksSecLimit(DpTransitDateQry qry)	POST /chart/marksSecLimit - 马科次限盘。
ApiResp<AstroDataVo>	chartMarksTripleLimit(DpTransitDateQry qry)	POST /chart/marksTripleLimit - 马科三限盘。
ApiResp<AstroDataVo>	chartNatal(SinglePointQry qry)	POST /chart/natal - 本命盘。
ApiResp<AstroDataVo>	chartSecondaryLimit(SpTransitDateQry qry)	POST /chart/secondaryLimit - 次限盘（Secondary progression）。
ApiResp<AstroDataVo>	chartSmallLimit(SpTransitDateQry qry)	POST /chart/smallLimit - 小限盘。
ApiResp<AstroDataVo>	chartSolarArc(SpTransitDateQry qry)	POST /chart/solarArc - 日弧盘（Solar arc）。
ApiResp<AstroDataVo>	chartSolarReturn(DoublePointQry qry)	POST /chart/solarReturn - 日回归盘（太阳回归）。
ApiResp<AstroDataVo>	chartTimesMidPoint(DoublePointQry qry)	POST /chart/timesMidPoint - 中点盘。
ApiResp<AstroDataVo>	chartTmpSecLimit(DpTransitDateQry qry)	POST /chart/tmpSecLimit - 临时次限盘。
ApiResp<AstroDataVo>	chartTmpTripleLimit(DpTransitDateQry qry)	POST /chart/tmpTripleLimit - 临时三限盘。
ApiResp<AstroDataVo>	chartTransit(DoublePointQry qry)	POST /chart/transit - 行运盘。
ApiResp<AstroDataVo>	chartTripleLimit(SpTransitDateQry qry)	POST /chart/tripleLimit - 三限盘。
void	close()	关闭客户端占用的线程池与连接池，避免进程退出时 OkHttp 线程未结束的 warning。
ApiResp<AstroEventVo>	eventTransit(ScopeQryReq qry)	POST /event/transit - 行运事件列表。
ApiResp<MySignRespVo>	mySign(String uid)	POST /mySign/{uid} - 用户星座（包含简要运势）。
ApiResp<NaksVo>	naksRelations(NaksQry qry)	POST /naks/relations - 星宿关系（本命 / 值日 / 与他人的关系）。
ApiResp<AstroReportVo>	reportGet(String uid, String serialNo)	GET /report/{uid}/{serialNo} - 获取报告 JSON 内容。
byte[]	reportGetHtml(String uid, String serialNo)	GET /report/{uid}/{serialNo}/html - 获取报告 HTML 内容（字节数组）。
ApiResp<AstroReportVo>	reportRomantic(RomanticCreateQry romanticCreateQry)	POST /report/romantic - 桃花报告（恋爱/吸引力）。
ApiResp<AstroReportVo>	reportTogether(TogetherCreateQry qry)	POST /report/together - 合盘报告。
ApiResp<AstroReportVo>	reportWealth(WealthCreateQry qry)	POST /report/wealth - 财运报告。
ApiResp<AstroReportVo>	reportWeeklyScope(WeeklyScopeCreateQry qry)	POST /report/weeklyScope - 周运报告。
ApiResp<AstroReportVo>	reportYearlyScope(YearlyScopeCreateQry qry)	POST /report/yearlyScope - 年运报告。
ApiResp<ScopeRespVo>	scopeDay(String uid, ScopeQryReq qry)	POST /scope/day/{uid} - 日运势。
ApiResp<ScopeRespVo>	scopeMonth(String uid, ScopeQryReq qry)	POST /scope/month/{uid} - 月运势。
ApiResp<ScopeRespVo>	scopeWeek(String uid, ScopeQryReq qry)	POST /scope/week/{uid} - 周运势。
ApiResp<ScopeRespVo>	scopeYear(String uid, ScopeQryReq qry)	POST /scope/year/{uid} - 年运势。
ApiResp<Map<String,List<SignCompatVo>>>	signCompat(String signId)	GET /signs/{signId}/compat - 星座配对关系。
ApiResp<SignVo>	signInfo(String signId)	GET /signs/{signId} - 星座详情。
ApiResp<List<SignVo>>	signsList()	GET /signs - 星座列表。
ApiResp<ZiweiChartVo>	ziweiChart(ZiweiQry qry)	POST /ziwei/chart - 紫微运限盘（带流年/流月等）。
ApiResp<ZiweiDetailVo>	ziweiDetail(ZiweiQry qry)	POST /ziwei/detail - 紫微运限 + 解读。
ApiResp<ZiweiNatalVo>	ziweiNatal(ZiweiNatalQry qry)	POST /ziwei/natal - 紫微本命盘。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

DEFAULT_BASE_URL

public static final String DEFAULT_BASE_URL

另请参阅:

• 常量字段值

构造器详细资料

AstroCloudClient

public AstroCloudClient(String appId,
 String appKey)

AstroCloudClient

public AstroCloudClient(String appId,
 String appKey,
 String baseUrl,
 long timeoutMillis)

方法详细资料

close

public void close()

关闭客户端占用的线程池与连接池，避免进程退出时 OkHttp 线程未结束的 warning。 调用后本客户端不可再使用。

指定者:

close 在接口中 AutoCloseable

chartNatal

public ApiResp<AstroDataVo> chartNatal(SinglePointQry qry)
                                throws IOException

POST /chart/natal - 本命盘。

参数:

qry - 单点星盘查询参数（出生时间 + 地理位置等）

返回:

本命盘数据封装在 ApiResp<AstroDataVo> 中

抛出:

IOException - 网络或反序列化异常

chartCurrent

public ApiResp<AstroDataVo> chartCurrent(SinglePointQry qry)
                                  throws IOException

POST /chart/current - 当前天象盘。 用于计算当前时间/地点的行星位置。

抛出:

IOException

chartTransit

public ApiResp<AstroDataVo> chartTransit(DoublePointQry qry)
                                  throws IOException

POST /chart/transit - 行运盘。 使用出生点 + 行运点两组时间地点。

抛出:

IOException

chartComparison

public ApiResp<AstroDataVo> chartComparison(DoublePointQry qry)
                                     throws IOException

POST /chart/comparison - 比较盘。

抛出:

IOException

chartComposite

public ApiResp<AstroDataVo> chartComposite(DoublePointQry qry)
                                    throws IOException

POST /chart/composite - 组合盘。

抛出:

IOException

chartTimesMidPoint

public ApiResp<AstroDataVo> chartTimesMidPoint(DoublePointQry qry)
                                        throws IOException

POST /chart/timesMidPoint - 中点盘。

抛出:

IOException

chartMarks

public ApiResp<AstroDataVo> chartMarks(DoublePointQry qry)
                                throws IOException

POST /chart/marks - Marks（马科）盘。

抛出:

IOException

chartLunarReturn

public ApiResp<AstroDataVo> chartLunarReturn(DoublePointQry qry)
                                      throws IOException

POST /chart/lunarReturn - 月回归盘。

抛出:

IOException

chartSolarReturn

public ApiResp<AstroDataVo> chartSolarReturn(DoublePointQry qry)
                                      throws IOException

POST /chart/solarReturn - 日回归盘（太阳回归）。

抛出:

IOException

chartTripleLimit

public ApiResp<AstroDataVo> chartTripleLimit(SpTransitDateQry qry)
                                      throws IOException

POST /chart/tripleLimit - 三限盘。 单点 + 行运日期。

抛出:

IOException

chartSecondaryLimit

public ApiResp<AstroDataVo> chartSecondaryLimit(SpTransitDateQry qry)
                                         throws IOException

POST /chart/secondaryLimit - 次限盘（Secondary progression）。

抛出:

IOException

chartFirdaria

public ApiResp<AstroDataVo> chartFirdaria(SpTransitDateQry qry)
                                   throws IOException

POST /chart/firdaria - 法达盘（Firdaria）。

抛出:

IOException

chartSmallLimit

public ApiResp<AstroDataVo> chartSmallLimit(SpTransitDateQry qry)
                                     throws IOException

POST /chart/smallLimit - 小限盘。

抛出:

IOException

chartSolarArc

public ApiResp<AstroDataVo> chartSolarArc(SpTransitDateQry qry)
                                   throws IOException

POST /chart/solarArc - 日弧盘（Solar arc）。

抛出:

IOException

chartComposeTripleLimit

public ApiResp<AstroDataVo> chartComposeTripleLimit(DpTransitDateQry qry)
                                             throws IOException

POST /chart/composeTripleLimit - 组合三限盘。

抛出:

IOException

chartComposeSecLimit

public ApiResp<AstroDataVo> chartComposeSecLimit(DpTransitDateQry qry)
                                          throws IOException

POST /chart/composeSecLimit - 组合次限盘。

抛出:

IOException

chartMarksTripleLimit

public ApiResp<AstroDataVo> chartMarksTripleLimit(DpTransitDateQry qry)
                                           throws IOException

POST /chart/marksTripleLimit - 马科三限盘。

抛出:

IOException

chartMarksSecLimit

public ApiResp<AstroDataVo> chartMarksSecLimit(DpTransitDateQry qry)
                                        throws IOException

POST /chart/marksSecLimit - 马科次限盘。

抛出:

IOException

chartTmpTripleLimit

public ApiResp<AstroDataVo> chartTmpTripleLimit(DpTransitDateQry qry)
                                         throws IOException

POST /chart/tmpTripleLimit - 临时三限盘。

抛出:

IOException

chartTmpSecLimit

public ApiResp<AstroDataVo> chartTmpSecLimit(DpTransitDateQry qry)
                                      throws IOException

POST /chart/tmpSecLimit - 临时次限盘。

抛出:

IOException

scopeDay

public ApiResp<ScopeRespVo> scopeDay(String uid,
 ScopeQryReq qry)
                              throws IOException

POST /scope/day/{uid} - 日运势。

参数:

uid - 业务方用户 ID（用于个性化缓存与透传）

抛出:

IOException

scopeWeek

public ApiResp<ScopeRespVo> scopeWeek(String uid,
 ScopeQryReq qry)
                               throws IOException

POST /scope/week/{uid} - 周运势。

抛出:

IOException

scopeMonth

public ApiResp<ScopeRespVo> scopeMonth(String uid,
 ScopeQryReq qry)
                                throws IOException

POST /scope/month/{uid} - 月运势。

抛出:

IOException

scopeYear

public ApiResp<ScopeRespVo> scopeYear(String uid,
 ScopeQryReq qry)
                               throws IOException

POST /scope/year/{uid} - 年运势。

抛出:

IOException

eventTransit

public ApiResp<AstroEventVo> eventTransit(ScopeQryReq qry)
                                   throws IOException

POST /event/transit - 行运事件列表。

抛出:

IOException

mySign

public ApiResp<MySignRespVo> mySign(String uid)
                             throws IOException

POST /mySign/{uid} - 用户星座（包含简要运势）。

抛出:

IOException

signsList

public ApiResp<List<SignVo>> signsList()
                                throws IOException

GET /signs - 星座列表。

抛出:

IOException

signInfo

public ApiResp<SignVo> signInfo(String signId)
                         throws IOException

GET /signs/{signId} - 星座详情。

抛出:

IOException

signCompat

public ApiResp<Map<String,List<SignCompatVo>>> signCompat(String signId)
                                                   throws IOException

GET /signs/{signId}/compat - 星座配对关系。

抛出:

IOException

baziNatal

public ApiResp<BaziNatalVO> baziNatal(BaziNatalQry qry)
                               throws IOException

POST /bazi/natal - 八字命盘。

抛出:

IOException

baziFlow

public ApiResp<BaziFlowVO> baziFlow(BaziFlowQry qry)
                             throws IOException

POST /bazi/flow - 八字流盘（带目标日期）。

抛出:

IOException

baziMatch

public ApiResp<BaziMatchVO> baziMatch(BaziMatchQry qry)
                               throws IOException

POST /bazi/match - 八字合盘（两个人）。

抛出:

IOException

baziSummary

public ApiResp<BaziSummaryVO> baziSummary(BaziNatalQry qry)
                                   throws IOException

POST /bazi/summary - 八字总结。

抛出:

IOException

ziweiNatal

public ApiResp<ZiweiNatalVo> ziweiNatal(ZiweiNatalQry qry)
                                 throws IOException

POST /ziwei/natal - 紫微本命盘。

抛出:

IOException

ziweiChart

public ApiResp<ZiweiChartVo> ziweiChart(ZiweiQry qry)
                                 throws IOException

POST /ziwei/chart - 紫微运限盘（带流年/流月等）。

抛出:

IOException

ziweiDetail

public ApiResp<ZiweiDetailVo> ziweiDetail(ZiweiQry qry)
                                   throws IOException

POST /ziwei/detail - 紫微运限 + 解读。

抛出:

IOException

naksRelations

public ApiResp<NaksVo> naksRelations(NaksQry qry)
                              throws IOException

POST /naks/relations - 星宿关系（本命 / 值日 / 与他人的关系）。

抛出:

IOException

reportRomantic

public ApiResp<AstroReportVo> reportRomantic(RomanticCreateQry romanticCreateQry)
                                      throws IOException

POST /report/romantic - 桃花报告（恋爱/吸引力）。创建报告任务并返回流水号。

抛出:

IOException

reportWeeklyScope

public ApiResp<AstroReportVo> reportWeeklyScope(WeeklyScopeCreateQry qry)
                                         throws IOException

POST /report/weeklyScope - 周运报告。

抛出:

IOException

reportYearlyScope

public ApiResp<AstroReportVo> reportYearlyScope(YearlyScopeCreateQry qry)
                                         throws IOException

POST /report/yearlyScope - 年运报告。

抛出:

IOException

reportTogether

public ApiResp<AstroReportVo> reportTogether(TogetherCreateQry qry)
                                      throws IOException

POST /report/together - 合盘报告。

抛出:

IOException

reportWealth

public ApiResp<AstroReportVo> reportWealth(WealthCreateQry qry)
                                    throws IOException

POST /report/wealth - 财运报告。

抛出:

IOException

reportGet

public ApiResp<AstroReportVo> reportGet(String uid,
 String serialNo)
                                 throws IOException

GET /report/{uid}/{serialNo} - 获取报告 JSON 内容。

抛出:

IOException

reportGetHtml

public byte[] reportGetHtml(String uid,
 String serialNo)
                     throws IOException

GET /report/{uid}/{serialNo}/html - 获取报告 HTML 内容（字节数组）。

抛出:

IOException