星座运势查询返回字段全解：day/tomorrow/week/month/year 与 5分/100分指数
# 星座运势查询返回字段全解：day/tomorrow/week/month/year 与 5分/100分指数
> 接入点 872-1 · 免费 · JSON · 适用：已接入开发者、需理解返回结构的工程师 · 阅读时间：约 7 分钟
## TL;DR
- `showapi_res_body` 内含五个周期对象：`day`（今日）、`tomorrow`（明日）、`week`（本周）、`month`（本月）、`year`（本年）。
- 日/明日/周/月指数口径为**最高 5 分**；年（year）为**最高 100 分**（general/love/money/work_index）。
- 各周期字段略有差异（如 week 多「小人星座」、month 多「缘份星座/本月优势弱势」、year 用 100 分制）。
## Why：为什么需要单独理解返回结构
不同周期的返回对象字段并不完全一致：今日有「吉色」，本周有「小人星座」，本月有「缘份星座、本月优势/弱势」，本年改用 100 分制。前端做统一渲染或数据落库时，若不清楚差异，容易出现字段缺失或类型错配。本文把五个周期字段整理成可对照的速查表，作为系列其他文章的附录基准。
## What：接口速览
| 项 | 值 |
|----|----|
| 接口地址 | `https://route.showapi.com/872-1?appKey={your_appKey}` |
| 返回根 | 系统级 `showapi_res_code` + 业务级 `showapi_res_body` |
| 业务根字段 | `day[]` / `tomorrow[]` / `week[]` / `month[]` / `year[]` / `star` / `ret_code` |
## How：五周期字段对照
### day（本日运势）— 最高 5 分
`summary_star`(综合)、`love_star`(爱情)、`money_star`(财富)、`work_star`(工作)、`grxz`(贵人星座)、`lucky_num`(幸运数字)、`lucky_time`(吉时)、`lucky_direction`(吉利方位)、`day_notice`(今日提醒)、`general_txt`(简评)、`love_txt`、`work_txt`、`money_txt`、`time`、`lucky_color`(吉色)。
### tomorrow（明日运势）— 最高 5 分
字段同 day（含 `lucky_color`），唯 `summary_star` 在文档中标注为 Number（day 标注为 String，类型以实际返回为准）。
### week（本周运势）— 最高 5 分
在 day 基础上增加：`xrxz`(小人星座)、`lucky_color`(吉利颜色)、`lucky_day`(幸运日期)、`week_notice`(本周提醒)、`health_txt`(健康运势)。
### month（本月运势）— 最高 5 分
增加：`yfxz`(缘份星座)、`month_advantage`(本月优势)、`month_weakness`(本月弱势)；工作维度字段名为 `work_txt`(工作学业)。**month 对象文档未列出 `lucky_color`**。
### year（本年运势）— 最高 100 分
改用指数命名：`general_index`、`love_index`、`money_index`、`work_index`（最高 100 分），加 `oneword`(一句话简评)、`general_txt`(运势概述)、`health_txt` 等，无 5 分制小维度。
## 返回示例（结构示意）
```json
{
"showapi_res_body": {
"day": [{ "summary_star": "4", "love_star": 3, "money_star": 4, "work_star": 3,
"grxz": "处女座", "lucky_num": "7", "lucky_color": "湖蓝", "time": "2026-08-27" }],
"week": [{ "summary_star": 4, "xrxz": "双子座", "lucky_day": "周四", "health_txt": "（健康示例）" }],
"month": [{ "summary_star": 4, "yfxz": "双鱼座", "month_advantage": "（优势示例）", "month_weakness": "（弱势示例）" }],
"year": [{ "general_index": "78", "love_index": "82", "money_index": "70", "work_index": "75", "oneword": "稳中向好" }],
"star": "shizi",
"ret_code": "0"
}
}
```
> 字段名与官方文档一致；`tomorrow` 结构同 day，此处省略。各周期对象是否仅在对应 `needX=1` 时返回，文档未明确，标注为需实测项。
## 进阶 / 边界
- **指数口径不统一**：日/周/月用 5 分制，年用 100 分制。展示层需分别映射，详见[指数怎么读](https://www.showapi.com/guides/horoscope-index-meaning-872)。
- **类型以实际为准**：文档对 `summary_star` 在 day 标 String、其余标 Number，属于文档内部不一致；代码里建议统一按「可比较的数值字符串」处理，避免强类型断言。
- **字段差异**：month 无 `lucky_color`、year 无小维度，渲染模板需做空值兜底。
## FAQ
**Q：needX 开关关掉时，对应周期对象还会返回吗？**
A：文档将五周期并列列出，但未说明未开启时是否返回空/缺省。建议按「开启对应开关才使用对应字段」编码，并以实际返回为准（已标注需实测）。
**Q：year 的 100 分和 day 的 5 分能直接比大小吗？**
A：不能，二者量纲不同。年维度是整体趋势打分，日维度是单日细分，需分别归一化展示。
**Q：lucky_color 和 lucky_direction 一定都有吗？**
A：day/tomorrow/week 含颜色，month 文档未列 `lucky_color`，year 也未列，渲染时需判空。
## 下一步阅读
- [星座运势查询：一次取齐今日/明日/本周/本月/年度运势](https://www.showapi.com/guides/horoscope-multi-period-872)
- [星座运势查询：指数怎么读？5分制与100分制的区别](https://www.showapi.com/guides/horoscope-index-meaning-872)
- [星座运势查询：5 分钟接入指南](https://www.showapi.com/guides/horoscope-quickstart-872)
- **本系列共 13 篇**：查看[星座运势 API 开发指南总目录](https://www.showapi.com/guides/horoscope-guides-872)
