# 黄历运势·黄历接入点详解：宜忌、冲煞、值神怎么用
> 接入点 856-2（黄历） · 免费服务 · 适用人群：开发者、传统文化产品策划 · 阅读时间约 7 分钟
## TL;DR
- 黄历接入点（856-2）返回约 22 个字段，覆盖农历、干支、宜、忌、冲煞、值神、节气、纳音等。
- 最常用字段：`yi`(宜)、`ji`(忌)、`chongsha`(冲煞)、`zhishen`(值神)、`nongli`(农历)、`ganzhi`(干支)。
- 做一次调用即可在一行日历/卡片里展示当天全部黄历要点。
## Why：黄历接入点能解决什么
做日历、日程、运势类功能时，用户最常问的就是「今天宜什么、忌什么、冲谁、值神吉凶」。这些正好是 856-2 的核心字段。本文讲清每个字段的**业务含义**和**展示建议**，避免把「值神」「值日」「冲煞」混为一谈。
## What：接入点速览
| 项目 | 内容 |
|------|------|
| 接入点 | 黄历 856-2 |
| 接口地址 | `https://route.showapi.com/856-2?appKey={your_appKey}` |
| 必填参数 | `ymd`（公历日期 `yyyyMMdd`） |
| 返回 | `showapi_res_body` 内约 22 个字段 |
| 查询范围 | 1901-01-01 至当前年份 |
> 返回字段完整列表见 [黄历运势返回字段全解](https://www.showapi.com/guides/huangli-response-fields-856)。
## How：调用与展示
### 步骤 1：调用并取核心字段
**Python（requests）**
```python
import requests
url = "https://route.showapi.com/856-2"
params = {"appKey": "YOUR_APPKEY", "ymd": "20260211"}
resp = requests.get(url, params=params, timeout=10)
body = resp.json().get("showapi_res_body", {})
if body.get("ret_code") != 0:
print("失败：", body.get("msg"))
else:
card = {
"农历": body.get("nongli"),
"干支": body.get("ganzhi"),
"生肖": body.get("shengxiao"),
"值神": body.get("zhishen"),
"值日": body.get("zhiri"),
"宜": body.get("yi"),
"忌": body.get("ji"),
"冲煞": body.get("chongsha"),
"吉神宜趋": body.get("jsyq"),
"凶神宜忌": body.get("xsyj"),
}
for k, v in card.items():
print(f"{k}：{v}")
```
**cURL**
```bash
curl "https://route.showapi.com/856-2?appKey=YOUR_APPKEY&ymd=20260211"
```
**Node.js（fetch）**
```js
const url = "https://route.showapi.com/856-2?appKey=YOUR_APPKEY&ymd=20260211";
const body = (await (await fetch(url)).json()).showapi_res_body || {};
if (body.ret_code !== 0) console.log("失败：", body.msg);
else console.log(body.nongli, body.ganzhi, "| 宜:", body.yi, "| 忌:", body.ji);
```
## 关键字段业务含义
- **`yi` / `ji`**：当日「宜」「忌」事项清单，以空格分隔（如 `动土 修造 装修 拆卸 出行`）。展示建议：拆分后做标签云。
- **`chongsha`**：冲煞，含「冲 X 煞 Y 正冲 Z(年份)」。展示建议：提示用户生肖相冲。
- **`zhishen`**：值神（如 `玉堂(黄道日)`），括号内标注黄道/黑道，是判断「日子吉凶」的核心。
- **`zhiri`**：十二值日（如 `平执位(凶)`），与值神互补。
- **`jsyq` / `xsyj`**：吉神宜趋 / 凶神宜忌，择日可参考。
- **`nayin`**：年/月/日纳音五行，命理类应用常用。
- **`jieqi24`**：当月 24 节气，日历标注节气用。
- **`qixiang`**：数九信息（如 `今日二九第2天`），冬季相关展示用。
- **`wxcy`**：五行穿衣，可能为空，展示需空值兜底。
## 返回示例
```json
{
"showapi_res_body": {
"ret_code": 0,
"nongli": "二零二五年正月(大)十四",
"zhishen": "玉堂(黄道日)",
"ganzhi": "庚子年 戊子月 己卯日",
"shengxiao": "属鼠",
"zhiri": "平执位(凶)",
"yi": "动土 修造 装修 拆卸 出行",
"ji": "祈福 安葬",
"chongsha": "冲鸡煞西 正冲癸酉(1933 1993)",
"jsyq": "天恩 神在 五合 民日 天德 玉堂 不将",
"xsyj": "岁刑 伐日 九丑 月刑 天罡 死神 天吏 天贼 致死",
"msg": "查询成功"
}
}
```
## 进阶 / 边界
- **只展示黄道日**：用 `zhishen` 是否含「黄道日」判断，但要注意「值神黄道」与「值日小黑道」可能不一致（如示例值神玉堂为黄道，值日平执位为凶），产品上需明确口径，避免误导。
- **日期范围**：仅支持 1901-01-01 至当前年份；越早的日期可能无数据，需兜底。
- **更新频率**：每年 1 月 1 日—1 月 3 日早上 9 点更新一次，年内数据稳定，适合做长期缓存（见 [缓存策略](https://www.showapi.com/guides/huangli-cache-cost-856)）。
## FAQ
**Q1：值神(黄道日) 和 值日(凶) 冲突，以哪个为准？**
A：两者是不同体系——值神属「大黄道」、值日属「十二建除（小黑道）」。文档未规定优先级，产品上建议分别展示并注明口径，不要替用户下「今天吉/凶」的结论。
**Q2：宜忌字段怎么拆成列表？**
A：按空格 `split()` 即可（如 `yi.split(" ")`）。
**Q3：农历里的「(大)」「(小)」是什么意思？**
A：指农历当月是大月（30 天）还是小月（29 天），属正常标注，直接展示即可。
**Q4：wxcy 经常为空，能不要这个字段吗？**
A：是否展示由你决定；为空时做好空值兜底，避免页面出现「五行穿衣：null」。
## 相关能力 / 下一步阅读
- [黄历运势返回字段全解：黄历/吉神凶煞/吉时字段一文读懂](https://www.showapi.com/guides/huangli-response-fields-856) —— 全部字段对照。
- [吉时查询接入点：如何给用户推荐当日吉时](https://www.showapi.com/guides/huangli-auspicious-hours-856) —— 补上「时辰」维度。
- [婚庆搬家择日场景：组合黄历+吉神凶煞+吉时做择日推荐](https://www.showapi.com/guides/huangli-date-selection-856) —— 多接入点联动。
- **本系列共 11 篇**：查看[黄历运势指南总目录](https://www.showapi.com/guides/huangli-guides-856)
