星座类产品的三条内容线：星座运势查询与星座配对的组合用法
约 12 分钟 入门星座运势API运营方案内容线设计会员体系
# 星座类产品的三条内容线：星座运势查询与星座配对的组合用法
接口 872（两接入点）· 免费服务 · POST / GET · 返回 JSON · 适用：运营、产品负责人 · 阅读时间：约 7 分钟 · 最后实测核对：2026-09-18
## 核心要点
- 星座运势查询接口（apiCode=872）与星座配对接口两个接入点，可以支撑三条内容线：每日运势留存、配对互动分享、周期深度内容。
- 数据每天 1 点、7 点、17 点更新，配合缓存与预热，用户请求基本不打到接口上。
- 增值点适合放在解读文案的长度、历史档案与去广告上；配对结果本身按接口文档口径只作娱乐参考。
## 三条内容线
星座内容的天然优势是每天都有新东西可看、可分享、可比较。围绕接口的两个接入点，能拆出三条各有侧重的线。
第一条是每日运势，面向打开频次。第二条是配对互动，面向分享带来的新用户。第三条是周期内容，面向愿意花更长时间的深度用户。
三条线共用同一份数据，落地成本主要在页面与推送，不在数据侧。
## 能力与场景对照
| 接入点 | 提供的数据 | 对应内容线 |
|---|---|---|
| 872-1 星座运势查询 | 今日、明日、本周、本月、本年五套运势 | 每日运势、周期内容 |
| 872-1 的 `date` 参数 | 按生日反推星座 | 生日专属入口 |
| 872-2 星座配对 | 八类指数与七段文案 | 配对互动、分享裂变 |
| 两者组合 | 个人运势加双人配对 | 情侣专区、关系专题 |
## 内容线一：每日运势
每日运势的落点是「今天」两个字。接口的更新时刻是每天 1 点、7 点、17 点，推送任务挂在 7 点这一轮之后，用户早上打开就能看到当天的新内容。
卡片上放四样东西：`summary_star` 做星级、`lucky_color` 做底色、`lucky_num` 做幸运数字、`general_txt` 做正文。这四项都在 `day` 对象里，一次调用全拿到。
引导回访的动作放在卡片底部，指向明日运势。明日的 `time` 实测是次日日期，可以和今日一起取，让用户点一下就能预览。
## 内容线二：配对互动
配对页面的价值在于分享。用户和朋友的配对结果里，`match` 是唯一有传播力的大数字，`proportion` 是天然的对比条。
文案区用 `review` 做标题，`suggest` 和 `predestination` 做正文。这两段实测都是一整段长文，适合折叠展示。
重复查询的收益很高：同一对星座的组合会被反复请求，而结果与日期无关。2026-09-18 实测同参数连调两次返回逐字节相同，缓存可以直接给长 TTL。
配对结果是娱乐性质，接口文档明确标注「数据结果仅供娱乐参考」。分享图上也带上这句说明。
## 内容线三：周期内容与会员
周期内容的落点是「趋势」。本周的 `week_notice` 与 `month_advantage` 是接口里最适合做深度解读的字段，`year` 的四个 100 分制指数适合做年度总览。
免费层给单周期的短解读，会员层给多周期的对照、历史档案与年度趋势。一年的数据按天落库，就能做出「去年今日」这类回访入口。
会员页的推荐位可以落到具体字段：`month_advantage` 与 `month_weakness` 是一组对照，`xrxz`（小人星座）与 `grxz`（贵人星座）是另一组。
## 组合玩法
Python（一次取齐多周期并落库）：
```python
import requests
def fetch_periods(star: str, appkey: str) -> dict:
data = requests.get("https://route.showapi.com/872-1", params={
"appKey": appkey, "star": star,
"needTomorrow": "1", "needWeek": "1", "needMonth": "1", "needYear": "1",
}, timeout=15).json()
if data.get("showapi_res_code") != 0:
raise RuntimeError(f"系统错误: {data.get('showapi_res_error')}")
body = data["showapi_res_body"]
if str(body.get("ret_code")) != "0":
raise RuntimeError(f"业务错误: {body.get('remark')}")
return body
body = fetch_periods("shizi", "YOUR_APPKEY")
print("今日:", body["day"]["summary_star"], body["day"]["lucky_color"])
print("本周:", body["week"]["week_notice"], body["week"]["lucky_day"])
print("本月:", body["month"]["month_advantage"])
print("本年:", body["year"]["general_index"], body["year"]["oneword"][:20])
```
cURL：
```bash
curl -G "https://route.showapi.com/872-1" \
--data-urlencode "appKey=YOUR_APPKEY" \
--data-urlencode "star=shizi" \
--data-urlencode "needTomorrow=1" \
--data-urlencode "needWeek=1" \
--data-urlencode "needMonth=1" \
--data-urlencode "needYear=1" \
--max-time 15
```
Node.js（配对页取数）：
```javascript
// 情侣专区：一次比对双方的星座
const [a, b] = ["tianxie", "shuiping"].sort();
const url = new URL("https://route.showapi.com/872-2");
Object.entries({ appKey: "YOUR_APPKEY", star1: a, gender1: "1", star2: b, gender2: "0" })
.forEach(([k, v]) => url.searchParams.set(k, v));
const data = await (await fetch(url, { signal: AbortSignal.timeout(5000) })).json();
const body = data.showapi_res_body;
if (String(body.ret_code) !== "0") throw new Error(body.remark);
console.log(parseInt(String(body.match), 10), body.proportion, body.review);
// 结果仅供参考，接口文档标注仅供娱乐
```
## 落地清单
| 环节 | 做法 |
|---|---|
| 数据刷新 | 定时任务在 1 点、7 点、17 点后预热 12 个星座 |
| 缓存分层 | Redis 挡用户请求，数据库留历史档案 |
| 推送节奏 | 挂在 7 点那一轮更新之后 |
| 兜底文案 | 接口不可用时展示缓存数据并给提示，不白屏 |
| 免责口径 | 配对结果页保留「数据结果仅供娱乐参考」 |
预热一轮 12 次调用，基础版档位每日 100 次，余量足够覆盖未命中缓存的场景。回源建议加令牌桶，把并发控制在 1 QPS 之内。
## 数据落库的注意事项
五个周期的 `time` 格式各不相同。2026-09-18 实测 `day` 是 `20260918`、`week` 是 `20260913-20260920`、`month` 是 `202609`、`year` 是 `2026`。做历史档案时要把它们分别落到日、周区间、月、年四个粒度上，混在一张表里按日期列排序会串。
`year` 的指数是带「分」字的字符串，和日维度的数字不能直接比大小，做趋势图前先归一化。
## FAQ
**Q1：免费接口能做商业化吗？**
可以。数据调用本身免费，增值点放在更长的解读、历史档案、年度对比与去广告上。
**Q2：配对分数能作为严肃的匹配结论吗？**
不建议。接口文档明确标注「数据结果仅供娱乐参考」，产品里应作为趣味互动呈现。
**Q3：每日推送会超出调用额度吗？**
用户请求走缓存，只有预热任务会回源。一轮预热 12 次调用，基础版每日 100 次。
**Q4：历史数据怎么存？**
按周期各自的粒度落库：日维度按天、周维度按区间、月维度按月、年维度按年。不要统一按天存，否则周月年的记录会被重复写入。
**Q5：情侣专区最该展示哪几个字段？**
`match` 做综合分，`proportion` 做比重条，`review` 做一句话点评。三项都短，适合卡片与分享图。
**Q6：接口挂了页面怎么兜底？**
展示上一次缓存的内容并给一句提示。新增星座或新增周期没有缓存时用占位文案，不要报错页。
## 下一步阅读
- [在星座社区与社交 App 里接入星座运势查询](https://www.showapi.com/guides/horoscope-community-app-872)
- [星座运势查询的缓存怎么设](https://www.showapi.com/guides/horoscope-cache-872)
- [星座配对返回字段全解：22 个字段的含义与实测取值](https://www.showapi.com/guides/constellation-match-fields-872)
- [星座运势查询返回字段全解：五个周期的字段对照](https://www.showapi.com/guides/horoscope-response-fields-872)
- **本系列共 13 篇**：查看[星座运势 API 指南总目录](https://www.showapi.com/guides/horoscope-guides-872)
