测吉凶（手机号/车牌号/QQ号/公司名）开发指南总目录
# 测吉凶（手机号/车牌号/QQ号/公司名）开发指南总目录
> 万维易源 API 接口编号 **1617** · 基于周易数理的数字吉凶分析工具 · 免费服务（注册后默认可调用，受账户档位限制）
> 本页为系列索引：从「5 分钟接入」到「四个接入点逐一用法」「expList 结构化解析」「MCP / OpenAPI 集成」，覆盖接入、实战、深挖、行业、生态全链路。
## 接口一句话速览
测吉凶（apiCode=1617）是万维易源官方自营的**生活服务类免费接口**，输入一个号码或名称，即可返回基于周易数理的吉凶预测与性格/运势参考。它包含 **4 个接入点**，覆盖最常见的四类输入：
| 接入点 | 名称 | 必填参数 | 说明 |
|------|------|---------|------|
| 1617-1 | 手机号测吉凶 | `mobile` | 输入手机号，返回号码数理、签语、吉凶、性格类型 |
| 1617-2 | 车牌号测吉凶 | `carNo` | 输入车牌号，返回命理、数理、车主性格暗示 |
| 1617-3 | QQ号测吉凶 | `qq` | 输入 QQ 号，返回号码数理、签语、性格类型 |
| 1617-4 | 公司名测吉凶 | `companyName` | 输入公司名称，返回吉凶参考（可能为空 expList，见专篇） |
统一请求：`POST/GET https://route.showapi.com/1617-N?appKey=YOUR_APPKEY`，表单 `application/x-www-form-urlencoded`，返回 JSON。返回业务数据均位于 `showapi_res_body` 内，其中 `expList` 为**字符串数组**（各接入点条目数量与内容不同）。
## 分层全列文章（共 13 篇）
### 入门层
1. [测吉凶：5 分钟接入指南（手机号/车牌号/QQ号/公司名）](https://www.showapi.com/guides/fortune-quickstart-1617) — 注册取 AppKey 到第一个调用跑通，附 Python/cURL/Node 代码。
2. [测吉凶返回字段全解：ret_code、remark 与 expList 数组一文读懂](https://www.showapi.com/guides/fortune-response-fields-1617) — 统一返回包裹结构，重点澄清 expList 是数组而非单值，title 恒空说明。
### 场景实战层
3. [手机号测吉凶：如何解析号码数理、签语与性格暗示？](https://www.showapi.com/guides/fortune-mobile-guide-1617) — 1617-1 专篇，expList 五条目逐行解读。
4. [车牌号测吉凶：命理、数理与车主性格暗示怎么读？](https://www.showapi.com/guides/fortune-carplate-guide-1617) — 1617-2 专篇，并说明实测无「归属地」的边界。
5. [QQ号测吉凶：号码数理与性格类型怎么解读？](https://www.showapi.com/guides/fortune-qq-guide-1617) — 1617-3 专篇，趣味社交场景举例。
6. [公司名测吉凶：接入点与「返回空 expList」边界说明](https://www.showapi.com/guides/fortune-company-guide-1617) — 1617-4 专篇，前端需做空数组兜底。
7. [做一个号码测吉凶小工具：HTML+JS 前端 Demo 实战](https://www.showapi.com/guides/fortune-web-demo-1617) — 纯前端表单按输入类型切换四个接入点，可复制运行。
### 技术深挖层
8. [expList 数组结构化解析：把「数理/签语/吉凶/详解」拆成字段](https://www.showapi.com/guides/fortune-expList-parse-1617) — 用「前缀：」切分，把非结构化文本转可入库字段。
9. [测吉凶错误处理与边界容错：ret_code 判断、空 expList、参数校验](https://www.showapi.com/guides/fortune-error-handling-1617) — ret_code 判断、必填缺失报错、空数组兜底、超时设置。
### 行业方案层
10. [娱乐/社交 App 集成测吉凶：加一个趣味「彩蛋」的低成本方案](https://www.showapi.com/guides/fortune-entertainment-use-1617) — 在注册/个人页嵌入口，限流与档位提示。
11. [婚恋/社交/客服赋能：用号码测吉凶做轻量趣味互动](https://www.showapi.com/guides/fortune-crm-empower-1617) — 活动页嵌入，强调「仅供参考、娱乐向」。
### 生态集成层
12. [通过 MCP 在 AI 客户端直接调用测吉凶（Cherry Studio / ChatBox）](https://www.showapi.com/guides/fortune-mcp-guide-1617) — 按文档 MCP JSON 配置，AI 对话里直接测吉凶。
13. [导入 Postman / Swagger：用 OpenAPI 文档管理测吉凶接口](https://www.showapi.com/guides/fortune-openapi-import-1617) — 下载 YAML 导入 API 工具，自动生成请求模板。
## 相关资源
- 接口详情页：[测吉凶 apiCode=1617](https://www.showapi.com/apiGateway/view/1617)
- 4 个接入点：[/1617/1 手机号](https://www.showapi.com/apiGateway/view/1617/1) · [/1617/2 车牌号](https://www.showapi.com/apiGateway/view/1617/2) · [/1617/3 QQ号](https://www.showapi.com/apiGateway/view/1617/3) · [/1617/4 公司名](https://www.showapi.com/apiGateway/view/1617/4)
- OpenAPI 文档：[YAML](https://www.showapi.com/openapi/market/1617.yaml) · [JSON](https://www.showapi.com/openapi/market/1617.json)
- AppKey 管理：[ShowAPI 控制台](https://www.showapi.com/console#/myApp)
- 免费档位说明：[了解积分与档位详情](https://www.showapi.com/free-api)
## 阅读建议
- **第一次接入**：按 1 → 2 → 3 顺序，先跑通快速开始，再理解返回结构，最后看手机号专篇上手。
- **要做前端/小程序**：直接看 7（前端 Demo）与 8（expList 解析），可省去自己摸索展示逻辑。
- **已接入想做得更稳**：重点看 9（错误处理）与 6（公司名空结果边界）。
- **想蹭 AI / API 治理热点**：看 12（MCP）与 13（OpenAPI 导入）。
> ⚠️ 内容合规提示：本接口结果为周易数理的娱乐性参考，**非科学结论**，上线时建议在页面显著位置标注「仅供娱乐、理性看待」，避免误导用户。
