# 手机号测吉凶：如何解析号码数理、签语与性格暗示？
> 接口/接入点：测吉凶 1617-1（手机号） · 免费服务 · 请求方式 POST/GET · 返回格式 JSON · 适用人群：开发者、活动运营 · 阅读时间：约 5 分钟
## 核心要点
- 1617-1 唯一必填业务参数：`mobile`（手机号，String）。
- 返回 `expList` 为 5 条：号码 / 数理 / 签语 / 吉凶 / 详解，均按「前缀：」组织，可直接逐行展示。
- 与 QQ 号接入点（1617-3）返回结构一致，解析逻辑可复用。
## Why：手机号是最常用的入口
手机号人人都有，做「输入手机号测吉凶」活动门槛极低、传播性好。理解 1617-1 的返回条目，你就能直接把「数理/签语/吉凶/性格类型」四块信息排进卡片，做成一个像样的趣味 H5。
## What：接口速览
| 项 | 说明 |
|------|------|
| 接口地址 | `https://route.showapi.com/1617-1?appKey=YOUR_APPKEY` |
| 必填参数 | `mobile`（String，手机号） |
| 返回 | `showapi_res_body.expList`（数组，5 条） |
## How：调用与解析
### Python
```python
import requests
r = requests.post("https://route.showapi.com/1617-1",
params={"appKey": "YOUR_APPKEY"},
data={"mobile": "13770000000"}, 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-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "mobile=13770000000"
```
### Node.js
```javascript
const res = await fetch("https://route.showapi.com/1617-1?appKey=YOUR_APPKEY",
{ method: "POST", body: new URLSearchParams({ mobile: "13770000000" }),
signal: AbortSignal.timeout(15000) });
const b = (await res.json()).showapi_res_body;
(b.expList || []).forEach((l) => console.log(l));
```
## 返回示例与解析
实测 1617-1 返回：
```json
{
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功！",
"title": "",
"expList": [
"号码：13770000000",
"数理：第81数",
"签语：最极之数，还本归元，能得繁业，发达成功",
"吉凶：吉",
"详解：主人的性格类型：[自我牺牲/性格被动型]，其具体表现为：习惯于无条件付出……"
]
}
}
```
| expList 条目 | 含义 | 展示建议 |
|------|------|------|
| `号码：…` | 回显输入号码 | 顶部标签 |
| `数理：第N数` | 周易数理序号 | 次级标题 |
| `签语：…` | 吉凶签文 | 主文案 |
| `吉凶：吉/凶` | 结论 | 高亮徽标 |
| `详解：…` | 性格类型与表现 | 折叠展开 |
## 进阶 / 边界
- 想从数组里拆出「吉凶」单独做徽标？见[expList 结构化解析](https://www.showapi.com/guides/fortune-expList-parse-1617)。
- `mobile` 参数文档未给出格式校验规则（如是否必须为 11 位），建议前端先自行做基础手机号格式校验再请求，减少无效调用。
- 结果为娱乐性参考，页面应标注「仅供娱乐」。
## FAQ
**Q：手机号格式有什么要求？**
文档未明确格式约束（如位数、号段）。建议前端做基础校验（如 11 位中国大陆手机号正则）后再调用，提升成功率。
**Q：expList 五条的顺序固定吗？**
实测为「号码→数理→签语→吉凶→详解」固定顺序，但解析时更稳妥的做法是按「前缀：」匹配而非依赖下标。
**Q：和 QQ 号接入点返回一样吗？**
结构一致（同为 5 条），仅前缀文案相同（`号码`/`数理`/`签语`/`吉凶`/`详解`），解析代码可复用。
**Q：能不能批量查很多手机号？**
本接口为同步单查，文档未提供批量能力。多号码需循环调用并注意免费档位限频，详见[错误处理与边界容错](https://www.showapi.com/guides/fortune-error-handling-1617)。
## 相关能力 / 下一步阅读
- [测吉凶返回字段全解：ret_code、remark 与 expList 数组一文读懂](https://www.showapi.com/guides/fortune-response-fields-1617)
- [QQ号测吉凶：号码数理与性格类型怎么解读？](https://www.showapi.com/guides/fortune-qq-guide-1617)
- [expList 数组结构化解析：把「数理/签语/吉凶/详解」拆成字段](https://www.showapi.com/guides/fortune-expList-parse-1617)
- **本系列共 13 篇**：查看[测吉凶指南总目录](https://www.showapi.com/guides/fortune-guides-1617)
