# 生肖运势查询 · 官方指南总目录
> 免费生肖运势查询（apiCode=2219）是易源（万维易源）官方自营的生活服务类接口：可获取 12 生肖每日、明日、每月运势，含事业、财运、爱情指数与开运颜色、方位、数字、饰物等个性化指导。本目录汇总全套官方指南，帮助你从注册调用到生产集成一步到位。
## 接口一句话速览
| 项 | 说明 |
|----|------|
| 接口名称 | 免费生肖运势查询 |
| 接入点 | 生肖运势查询（接入点 1） |
| 接口地址 | `https://route.showapi.com/2219-1?appKey={your_appKey}` |
| 请求方式 | POST / GET |
| 返回格式 | JSON |
| 计费 | 免费（注册后默认可调用，设使用档位限制防滥用） |
| 更新频率 | 每两小时更新 12 生肖最新运势 |
| 鉴权 | query 参数 `appKey` |
| 集成能力 | MCP 服务、OpenAPI 3.0 文档（YAML / JSON） |
| 服务商 | 昆明秀派科技有限公司（易源官方自营） |
## 分层文章目录
### 入门层
1. **[生肖运势查询：5 分钟接入，从注册到第一条运势结果](https://www.showapi.com/guides/shengxiao-fortune-quickstart-2219)** — 注册、拿 AppKey、第一次调用并解析返回，含可直接运行的 Python / cURL / Node.js 代码。
2. **[生肖运势查询：返回字段全解（day / month / tomorrow 三大对象差异与指数说明）](https://www.showapi.com/guides/shengxiao-fortune-response-fields-2219)** — 逐字段拆解返回结构，重点讲清今日/明日/本月三个对象字段集合不同的关键事实，避免取错字段。
### 场景实战层
3. **[生肖运势查询：sx 参数（12 生肖拼音编码）正确用法与对照表](https://www.showapi.com/guides/shengxiao-fortune-sx-param-2219)** — `sx` 是唯一必填参数，附 12 个拼音码与中文生肖对照表及传参建议。
4. **[生肖运势查询：如何同时拿到今日 / 明日 / 本月运势（needTomorrow / needMonth 开关）](https://www.showapi.com/guides/shengxiao-fortune-daily-monthly-2219)** — 两个可选开关的组合用法与适用场景。
5. **[生肖运势查询：用 HTML + JS 做一个生肖运势卡片 Demo（含指数与开运信息展示）](https://www.showapi.com/guides/shengxiao-fortune-web-demo-2219)** — 纯前端运势卡片，演示指数与开运信息如何渲染。
6. **[生肖运势查询：集成到网站 / 小程序 / 公众号的实战方案](https://www.showapi.com/guides/shengxiao-fortune-app-integration-2219)** — 三种 consumer 场景的接入要点与 AppKey 安全。
### 技术深挖层
7. **[生肖运势查询：每 2 小时更新，如何设计缓存避免重复调用](https://www.showapi.com/guides/shengxiao-fortune-cache-2219)** — 按 `sx + 日期` 维度缓存、TTL≈2h 的生产级写法，省免费额度。
### 生态集成层
8. **[生肖运势查询：通过 MCP 在 Cherry Studio / ChatBox 等 AI 客户端直接调用](https://www.showapi.com/guides/shengxiao-fortune-mcp-2219)** — 基于官方 MCP 配置让 AI 助手直接查运势。
9. **[生肖运势查询：导入 Postman / Swagger UI 管理接口（OpenAPI 3.0）](https://www.showapi.com/guides/shengxiao-fortune-openapi-import-2219)** — 下载 YAML 导入 API 工具，自动生成请求模板与 Mock。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/2219 |
| 接入点说明 | https://www.showapi.com/apiGateway/view/2219/1 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/2219.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/2219.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费档位说明 | https://www.showapi.com/free-api |
## 阅读建议
- **第一次接入**：按 1 → 2 → 3 顺序，先跑通调用、读懂字段、搞清必填参数。
- **做前端/小程序**：读 5（Demo）→ 6（集成方案）→ 7（缓存）。
- **做 AI / API 治理**：读 8（MCP）→ 9（OpenAPI 导入）。
> 本页为生肖运势查询官方指南总目录，系列共 9 篇正文 + 本目录页。
