星座配对：返回字段与配对指数全解（match/love/married/forever…）
# 星座配对：返回字段与配对指数全解（match/love/married/forever…）
> 接入点 872-2 · 免费 · JSON · 适用：已接入开发者、需理解配对返回结构的工程师 · 阅读时间：约 7 分钟
## TL;DR
- 星座配对返回 8 类指数：综合 `match`、爱情 `love`、婚姻 `married`、天长地久 `forever`、两情相悦 `lqxy`、友情 `friendship`、亲情 `affection`、配对比重 `proportion`。
- 另有 5 段解析文案：`suggest`(恋爱建议)、`match_case`(配对示例)、`predestination`(缘分解析)、`attention`(注意事项)、`review`(速配点评)。
- 所有指数均为**字符串**（如「70分」「3」），展示前需自行解析为数值；结果「仅供娱乐参考」。
## Why：为什么单开一篇讲字段
配对返回的指数和文案字段较多，且命名分散（`match` 是「70分」、`love` 是「3」、`proportion` 是「54:46」）。做卡片、进度条、分享图时，需要明确每个字段的含义与类型，避免把「70分」当整数、把「3」当百分比。本文按「指数类 / 文案类 / 元信息类」梳理成速查表。
## What：接口速览
| 项 | 值 |
|----|----|
| 接口地址 | `https://route.showapi.com/872-2?appKey={your_appKey}` |
| 返回根 | `showapi_res_body` + `ret_code` |
| 免责 | 「数据结果仅供娱乐参考」 |
## How：字段对照
### 指数类（字符串，建议解析后渲染）
| 字段 | 含义 | 示例 |
|------|------|------|
| `match` | 综合配对指数 | 「70分」 |
| `love` | 爱情配对指数 | 「3」 |
| `married` | 婚姻配对指数 | 「2」 |
| `forever` | 天长地久指数 | 「1」 |
| `lqxy` | 两情相悦指数 | 「3」 |
| `friendship` | 友情配对指数 | 「2」 |
| `affection` | 亲情配对指数 | 「2」 |
| `proportion` | 星座配对比重 | 「54:46」 |
### 文案类
| 字段 | 含义 |
|------|------|
| `suggest` | 恋爱建议 |
| `match_case` | 配对示例（如神话/名人组合类比） |
| `predestination` | 缘分解析 |
| `attention` | 注意事项 |
| `review` | 星座速配点评（如「还蛮不错的一对」） |
| `info` | 其它建议 |
| `remark` | 提示信息（如「查询成功！」） |
### 元信息类
| 字段 | 含义 |
|------|------|
| `star1` / `star2` | 两方星座英文码 |
| `grxz1` / `grxz2` | 两方星座中文名 |
| `gender1` / `gender2` | 两方性别（男/女） |
## 返回示例（结构示意）
```json
{
"showapi_res_body": {
"match": "70分", "love": "3", "married": "2", "forever": "1",
"lqxy": "3", "friendship": "2", "affection": "2", "proportion": "54:46",
"star1": "tianxie", "star2": "shuiping",
"grxz1": "天蝎座", "grxz2": "水瓶座",
"gender1": "男", "gender2": "女",
"suggest": "（恋爱建议示例）",
"predestination": "（缘分解析示例）",
"review": "还蛮不错的一对",
"ret_code": "0"
}
}
```
## 进阶 / 边界
- **字符串解析**：`match` 含「分」字，`love` 等是纯数字字符串，渲染进度条前统一 `parseInt` 并约定满分值（文档未给满分基线，建议按自身 UI 设定，不臆造）。
- **满分基线未知**：文档未说明各维度满分（爱情/婚姻等用几分为满），对外展示时建议用「相对星级」而非绝对百分比，避免误导。
- **娱乐性质**：所有指数与文案均仅供娱乐，产品中保留免责声明。
## FAQ
**Q：love=3 代表几分？满分是多少？**
A：文档未给出爱情等维度的满分基线，建议以星级或相对条展示，不标注具体百分比，并保留娱乐免责。
**Q：proportion「54:46」怎么理解？**
A：表示两方在配对中的倾向比重，仅作趣味参考，具体含义以文案字段（`suggest`/`review`）为准。
**Q：可以只展示综合指数 match 吗？**
A：可以，挑需要的字段渲染即可；其它字段可存入数据库供后续分析或分享图使用。
## 下一步阅读
- [星座配对：5 分钟接入指南](https://www.showapi.com/guides/constellation-match-quickstart-872)
- [星座运势 API：星座社区与社交 App 集成场景设计](https://www.showapi.com/guides/horoscope-community-app-872)
- [星座运势 API：星座运营产品方案](https://www.showapi.com/guides/horoscope-product-plan-872)
- **本系列共 13 篇**：查看[星座运势 API 开发指南总目录](https://www.showapi.com/guides/horoscope-guides-872)
