# QQ号测吉凶：号码数理与性格类型怎么解读？
> 接口/接入点：测吉凶 1617-3（QQ号） · 免费服务 · 请求方式 POST/GET · 返回格式 JSON · 适用人群：社交/社区产品开发者 · 阅读时间：约 5 分钟
## 核心要点
- 1617-3 唯一必填业务参数：`qq`（QQ号，String）。
- 返回 `expList` 与手机号接入点结构一致：号码 / 数理 / 签语 / 吉凶 / 详解，5 条。
- 适合做社交产品的趣味互动（个人资料页、好友 PK 等）。
## Why：QQ 号是社交场景的天然钩子
QQ 号陪伴用户多年，且「号越老越有故事」。在社群、游戏公会、二次元社区里加一个「测测你的 QQ 号吉凶」彩蛋，互动成本低、分享欲强。
## What：接口速览
| 项 | 说明 |
|------|------|
| 接口地址 | `https://route.showapi.com/1617-3?appKey=YOUR_APPKEY` |
| 必填参数 | `qq`（String，QQ号） |
| 返回 | `showapi_res_body.expList`（数组，5 条） |
## How：调用与解析
### Python
```python
import requests
r = requests.post("https://route.showapi.com/1617-3",
params={"appKey": "YOUR_APPKEY"},
data={"qq": "10001"}, timeout=15)
r.raise_for_status()
b = r.json()["showapi_res_body"]
if b.get("ret_code") != "0":
print("失败：", b.get("remark"))
else:
for line in b.get("expList") or []:
print(line)
```
### cURL
```bash
curl -X POST "https://route.showapi.com/1617-3?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "qq=10001"
```
### Node.js
```javascript
const res = await fetch("https://route.showapi.com/1617-3?appKey=YOUR_APPKEY",
{ method: "POST", body: new URLSearchParams({ qq: "10001" }),
signal: AbortSignal.timeout(15000) });
const b = (await res.json()).showapi_res_body;
(b.expList || []).forEach((l) => console.log(l));
```
## 返回示例与解析
实测 1617-3 返回：
```json
{
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功！",
"title": "",
"expList": [
"号码：10001",
"数理：第1数",
"签语：大展鸿图，信用得固，无远弗界，可获成功",
"吉凶：吉",
"详解：主人的性格类型：[不善表达/疑心重型]，其具体表现为：在乎身边各人对自己的评价……"
]
}
}
```
条目含义与手机号一致：`号码`（回显）、`数理`（周易序号）、`签语`（吉凶签文）、`吉凶`（结论，可做徽标）、`详解`（性格类型与表现）。
## 进阶 / 边界
- 与 1617-1 共用同一套 5 条解析逻辑，可抽成同一函数按接入点切换参数名。
- `qq` 参数文档未给格式约束，建议前端做基础非空/数字校验后再请求。
- 结果为娱乐参考，社交场景展示时建议加「仅供娱乐」标识，避免过度解读。
## FAQ
**Q：QQ 号和手机号返回结构一样吗？**
一样，均为 5 条（号码/数理/签语/吉凶/详解），解析代码可复用，仅参数名 `qq` 不同。
**Q：qq 参数要传数字还是字符串？**
文档定义为 String，建议以字符串传入（如 `"10001"`），避免前导零等被吞。
**Q：能把 QQ 吉凶做成好友 PK 吗？**
可以。分别调用两人的 1617-3，取各自 `吉凶` 与 `数理` 对比展示即可；注意免费档位限频，批量请参考[错误处理与边界容错](https://www.showapi.com/guides/fortune-error-handling-1617)。
**Q：返回里的「性格类型」能直接当标签用吗？**
可以提炼为趣味标签（如「疑心重型」），但务必标注娱乐属性，不得用于真实用户画像或信用评估。
## 相关能力 / 下一步阅读
- [手机号测吉凶：如何解析号码数理、签语与性格暗示？](https://www.showapi.com/guides/fortune-mobile-guide-1617)
- [测吉凶返回字段全解：ret_code、remark 与 expList 数组一文读懂](https://www.showapi.com/guides/fortune-response-fields-1617)
- [expList 数组结构化解析：把「数理/签语/吉凶/详解」拆成字段](https://www.showapi.com/guides/fortune-expList-parse-1617)
- **本系列共 13 篇**：查看[测吉凶指南总目录](https://www.showapi.com/guides/fortune-guides-1617)
