# 紫微斗数排盘 API 指南总目录
> 易源（万维易源）官方接口 **紫微斗数排盘 API（apiCode=1647）** 全系列指南索引。本文汇总 12 篇指南，按阅读顺序编排，便于从入门到架构逐步深入。
## 一句话速览
紫微斗数排盘 API 是易源官方提供的**免费**接口：输入求卦者的**阳历出生时间（精确到小时）**与**性别**，即可返回完整紫微斗数命盘，包含五行局、命宫/身宫、命主/身主、十二宫（每宫主星、辅星、十二星、大限、小限、干支）等。接口支持 MCP 与 OpenAPI 集成，适用于传统文化研究、命理工具类网站与 AI 客户端调用。
> 官方定位：本接口为「命理研究提供参考工具，禁止用于封建迷信」。全部指南仅从技术集成与字段解读角度展开。
## 接口速览
| 项目 | 内容 |
|------|------|
| 接口名称 | 免费排盘 - 紫微斗数 |
| apiCode | 1647 |
| 接入点 | 排盘（接入点 1，地址 `https://route.showapi.com/1647-1`） |
| 请求方式 | POST / GET |
| 返回格式 | JSON |
| 计费 | 免费调用（注册后默认可用，设有使用档次限制，见 [免费 API 档位说明](https://www.showapi.com/free-api)） |
| 更新频率 | 每年年底不定时更新一次当年数据 |
| 集成能力 | MCP 服务、OpenAPI 文档（YAML/JSON） |
| 服务商 | 昆明秀派科技有限公司 |
| 所属分类 | 生活服务 |
## 全系列文章（12 篇）
### 入门层
1. [紫微斗数排盘API：5分钟接入，从注册到第一张命盘](https://www.showapi.com/guides/ziwei-doushu-quickstart-1647) — 注册、拿 AppKey、第一次调用并解析返回。
2. [紫微斗数排盘API返回字段全解：五行局、十二宫、主星一文读懂](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647) — `result` 与 `pan` 全部字段对照表与结构图。
### 场景实战层
3. [紫微斗数排盘API如何集成到传统文化网站？从出生表单到命盘可视化](https://www.showapi.com/guides/ziwei-doushu-website-integration-1647) — 前端表单 + 渲染十二宫的完整链路。
4. [紫微斗数排盘API参数指南：time 阳历格式与 gender 性别的正确传法](https://www.showapi.com/guides/ziwei-doushu-params-guide-1647) — `time`/`gender` 必填规则与常见传错排查。
### 技术深挖层
5. [紫微斗数十二宫详解：命宫、财帛、事业等 12 宫字段怎么读](https://www.showapi.com/guides/ziwei-doushu-twelve-palaces-1647) — 十二宫顺序、宫名与星曜字段逐一解读。
6. [紫微斗数大限与小限解读：bLimit / sLimit 字段推算人生阶段](https://www.showapi.com/guides/ziwei-doushu-limit-interpret-1647) — 大限小限结构与展示建议（仅供参考）。
7. [紫微斗数五行局与命主身主解读：wx / mz / sz / sx 字段含义](https://www.showapi.com/guides/ziwei-doushu-wx-mz-sz-1647) — 五行局、命主、身主、身宫、阴阳、生肖说明。
8. [免费档位限制下，如何设计缓存策略节省紫微斗数排盘调用成本？](https://www.showapi.com/guides/ziwei-doushu-cache-cost-1647) — 以 `(time,gender)` 维度缓存，省免费额度。
### 高并发 / 行业方案层
9. [高并发排盘架构：异步队列 + 缓存处理紫微斗数排盘请求](https://www.showapi.com/guides/ziwei-doushu-high-concurrency-1647) — 同步单条模型的并发改造思路。
10. [传统文化研究平台方案：多用户命盘如何统一管理？](https://www.showapi.com/guides/ziwei-doushu-research-platform-1647) — 多用户批量生成、存储与异常识别。
### 生态集成层
11. [通过 MCP 协议在 AI 客户端中直接调用紫微斗数排盘](https://www.showapi.com/guides/ziwei-doushu-mcp-integration-1647) — 在 Cherry Studio / ChatBox 配置 `showapi-mcp-1647`。
12. [导入 Postman / Swagger：用 OpenAPI 文档管理紫微斗数接口](https://www.showapi.com/guides/ziwei-doushu-openapi-import-1647) — 下载 YAML 导入 API 工具，生成请求模板与 Mock。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/1647 |
| 接入点「排盘」 | https://www.showapi.com/apiGateway/view/1647/1 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/1647.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/1647.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费 API 档位说明 | https://www.showapi.com/free-api |
| 使用向导 | https://www.showapi.com/helpcenter/view#/3960/1 |
## 阅读建议
- **第一次用**：从「5分钟接入」开始，跑通第一张命盘。
- **做集成开发**：先看「返回字段全解」与「参数指南」，再看「网站集成」。
- **做技术架构**：读「缓存策略」「高并发架构」「研究平台方案」。
- **用 AI / 做 API 治理**：直接看「MCP 集成」与「OpenAPI 导入」。
- 全部文章统一以技术/字段解读视角展开，命运类字段均标注「传统文化研究参考，仅供参考」。
