星座周期趋势解读（异步任务）

支持输入中文或英文星座名称，便于在星座选择器或多语言表单中使用同一个查询入口。

也可通过公历生日确定星座，适合从用户主动填写的生日资料生成对应的星座文化内容。

返回星座中文名称、英文标识及日期范围，便于在页面中展示并核对所查询的星座。

支持今日、明日、本周、本月和本年五种周期，可按栏目需要组织不同时间跨度的内容。

支持指定目标日期并返回周期起止范围，便于让读者明确每份内容对应的查询时间。

提供周期主题及事业学习解读，便于按主题概要、阶段观察和具体建议组织阅读顺序。

关系沟通内容包含情景与沟通重点，可作为星座栏目中独立的社交文化阅读章节。

生活节奏内容包含精力分配和环境调整建议，便于丰富日常生活主题的阅读材料。

支持简体中文、繁体中文和英文内容，适合面向不同语言读者的星座文化产品。

支持同步、异步任务和流式获取，可用于周期内容栏目、完整报告及逐步显示的阅读页面。

相关解读仅供娱乐、传统文化研究与参考，不代表经科学验证的预测，不应作为医疗、法律、投资、婚姻或职业等重要现实决策的唯一依据。

当前接口契约

接口详情：https://www.gugudata.com/api/details/western-zodiac-period-insight

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	支持 Query、X-GUGUDATA-APPKEY、Bearer 或 JSON body。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
sign	string	否	无	中英文星座名称；与 birthDate 必须且只能传一个。
birthDate	string	否	N/A	公历出生日期，按固定日期边界换算星座。
period	string	否	today	支持 today、tomorrow、week、month、year。
targetDate	string	否	N/A	目标日期，格式 YYYY-MM-DD，范围 1901-01-01 至 2100-12-31；不传时使用北京时间当天。
language	string	否	zh-CN	支持 zh-CN、zh-TW、en-US。
responseMode	string	否	sync	支持 sync 或 task。
streaming	boolean	否	false	SSE 仅支持同步模式。

正常响应字段

字段	类型	说明
DataStatus.StatusCode	integer	业务码，100 表示成功。
DataStatus.StatusDescription	string	业务状态说明。
Data.基础数据.星座	string	规范化星座。
Data.基础数据.周期	string	本次内容周期。
Data.基础数据.周期标识	string	周期标识。
Data.基础数据.输入信息	object	输入方式、规范化输入值和输出语言。
Data.基础数据.星座计算	object	英文标识、日期范围、计算方式和边界说明。
Data.基础数据.目标日期	string	周期计算基准日期。
Data.基础数据.周期范围	object	北京时间下的开始日期和结束日期。
Data.文化解读	object	固定结构的星座周期文化内容。
Data.免责声明	string	文化研究与娱乐参考边界。
Data.operationId	string	任务模式的任务标识。
Data.status	string	任务状态。
Data.pollingUrl	string	任务状态查询地址。
Data.result	object	任务成功时的完整结果。
Data.error	object	任务失败信息。
SSE.done.result	object	流式完成事件的完整已校验结果。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	HTTP 200
501	参数错误	HTTP 400
502	请求频率受限	HTTP 429
503	订单已到期	HTTP 403
504	APPKEY 错误	HTTP 401，包含缺少 APPKEY
505	调用额度耗尽	HTTP 403
900	内部错误	HTTP 500
901	依赖服务不可用	HTTP 503

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求成功（业务码 100）。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0
    },
    "Data": {
        "基础数据": {
            "星座": "白羊座",
            "周期": "today",
            "周期标识": "string",
            "输入信息": {
                "输入方式": "星座名称",
                "规范化输入值": "string",
                "输出语言": "zh-CN"
            },
            "星座计算": {
                "星座": "白羊座",
                "英文标识": "aries",
                "日期范围": "string",
                "计算方式": "直接输入",
                "边界说明": "string"
            },
            "目标日期": "2019-08-24",
            "周期范围": {
                "开始日期": "2019-08-24",
                "结束日期": "2019-08-24",
                "时区": "Asia/Shanghai"
            }
        },
        "文化解读": {
            "周期主题": "string",
            "事业与学习": {
                "整体": "string",
                "有利方向": [
                    "string"
                ],
                "节奏变化": [
                    {
                        "阶段": "string",
                        "解读": "string"
                    }
                ],
                "潜在挑战": [
                    "string"
                ],
                "执行策略": "string"
            },
            "关系沟通": {
                "整体": "string",
                "可能情景": [
                    "string"
                ],
                "沟通重点": [
                    "string"
                ],
                "建议": [
                    "string"
                ]
            },
            "生活节奏": {
                "整体": "string",
                "精力分配": [
                    {
                        "场景": "string",
                        "建议": "string"
                    }
                ],
                "环境调整": [
                    "string"
                ],
                "建议": [
                    "string"
                ]
            },
            "建议": [
                "string"
            ],
            "提醒": [
                "string"
            ]
        },
        "免责声明": "string"
    }
}

🟠400参数错误（业务码 501）。

🟠401APPKEY 错误（业务码 504）。

🟠403订单已到期（业务码 503）；调用额度耗尽（业务码 505）。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限（业务码 502）。

🔴500内部错误（业务码 900）。

🔴502数据服务暂时不可用，请稍后重试。

🔴503依赖服务不可用（业务码 901）。

星座周期趋势解读（异步任务）

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明