黄历运势·吉神凶煞查询接入点：财神喜神方位与择日应用
# 黄历运势·吉神凶煞查询接入点：财神喜神方位与择日应用
> 接入点 856-4（吉神凶煞） · 免费服务 · 适用人群：开发者、择日/风水类应用策划 · 阅读时间约 8 分钟
## TL;DR
- 吉神凶煞接入点（856-4）返回约 30 个字段，覆盖神煞方位（财神/喜神/福神/贵神）、三煞、太岁、十二值神/值日、九星、六曜、二十八宿等。
- 高频字段：`caishen`(财神)、`xishen`(喜神)、`fushen`(福神)、`yangguishen`/`yinguishen`(阳/阴贵神)、`taisuiwei`(太岁位)、`tjjs`(推荐吉时)。
- 适合做「每日方位宜忌」「安床/开业择日」「生肖犯太岁提醒」等功能。
## Why：吉神凶煞接入点能做什么
黄历接入点给「日」的结论，吉神凶煞接入点给「神煞与方位」的细节——财神在哪个方向、今天冲不冲太岁、哪些生肖犯太岁、十二值神与值日怎么判。这类数据是开业、安床、出行择日类应用的核心素材。
## What：接入点速览
| 项目 | 内容 |
|------|------|
| 接入点 | 吉神凶煞 856-4 |
| 接口地址 | `https://route.showapi.com/856-4?appKey={your_appKey}` |
| 必填参数 | `ymd`（公历日期 `yyyyMMdd`） |
| 返回 | `showapi_res_body` 内约 30 个字段 |
| 查询范围 | 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-4"
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:
tips = {
"财神": body.get("caishen"),
"喜神": body.get("xishen"),
"福神": body.get("fushen"),
"阳贵神": body.get("yangguishen"),
"阴贵神": body.get("yinguishen"),
"太岁位": body.get("taisuiwei"),
"岁破位": body.get("suipowei"),
"推荐吉时": body.get("tjjs"),
}
for k, v in tips.items():
print(f"{k}：{v}")
```
**cURL**
```bash
curl "https://route.showapi.com/856-4?appKey=YOUR_APPKEY&ymd=20260211"
```
**Node.js（fetch）**
```js
const url = "https://route.showapi.com/856-4?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.caishen, "| 喜神:", body.xishen, "| 推荐吉时:", body.tjjs);
```
## 高频字段业务含义
- **`caishen` / `xishen` / `fushen`**：财神/喜神/福神方位（如「正北」），适合做「今日求财朝正北」类提示。
- **`yangguishen` / `yinguishen`**：阳贵神/阴贵神方位。
- **`taisuiwei` / `suipowei`**：太岁位/岁破位，择日避讳用。
- **`fantaisui`**：犯太岁生肖列表（如「鼠、马、羊、兔」），可做生肖年度提醒。
- **`niantaisui`**：当年太岁星君名（如「卢秘星君」）。
- **`zhishen12` / `zhiri12`**：十二值神/十二值日，含黄道/黑道与释义。
- **`tjjs`**：推荐吉时（如「寅,卯,午」），与吉时接入点互补。
- **`yuesansha` / `niansansha` / `risansha`**：月/年/日三煞，含方位与坐煞信息。
- **`jiuxing` / `liuyao` / `esbx` / `yjgx` / `wuhou`**：九星、六曜、二十八宿、易经卦象、物候，命理/节气类展示用。
## 返回示例（节选）
```json
{
"showapi_res_body": {
"ret_code": 0,
"caishen": "正北",
"xishen": "东北",
"fushen": "正北",
"yangguishen": "正北",
"yinguishen": "西南",
"taisuiwei": "正北",
"suipowei": "正南",
"fantaisui": "鼠、马、羊、兔",
"niantaisui": "卢秘星君",
"tjjs": "寅,卯,午",
"zhishen12": "玉堂 ― 吉：俗称“大黄道日”…",
"zhiri12": "平执位 ― 凶：俗称“小黑道日”…",
"jiuxing": "七赤咸池金星(凶)",
"liuyao": "先胜 ― 平(上午吉，下午凶)…",
"esbx": "东方尾宿尾火虎(吉)",
"yjgx": "水泽节",
"wuhou": "水泉动",
"msg": "查询成功"
}
}
```
## 进阶 / 边界
- **方位是「方位词」不是坐标**：`caishen` 等返回「正北」这类文字，不是经纬度，无法直接做地图标点；如需地图，需自建方位词→角度的映射。
- **`zhishen12`/`zhiri12` 含长释义**：示例被截断（`…`），完整释义以接口实际返回为准，展示时注意截断处理。
- **犯太岁是年度概念**：`fantaisui` 按年变化，适合年度提醒而非每日；与黄历的每日冲煞是两回事。
## FAQ
**Q1：财神方位能直接画在地图上吗？**
A：返回是方位词（正北/东北等），不是坐标。需要地图展示的话，自行把方位词映射到角度，接口不提供经纬度。
**Q2：tjjs 推荐吉时和吉时接入点（856-3）的吉时为什么不一样？**
A：两者口径不同——`tjjs` 是吉神凶煞接入点给的「推荐吉时」（地支列表如寅卯午），856-3 是逐时辰吉凶全量数据。产品上可二选一或组合，文档未规定统一口径。
**Q3：犯太岁的生肖每年都变吗？**
A：会变，属年度数据；接口按查询日期所在年返回当年的 `fantaisui` 与 `niantaisui`。
## 相关能力 / 下一步阅读
- [吉时查询接入点：如何给用户推荐当日吉时](https://www.showapi.com/guides/huangli-auspicious-hours-856) —— 时辰级吉凶。
- [黄历查询接入点详解：宜忌、冲煞、值神怎么用](https://www.showapi.com/guides/huangli-day-almanac-856) —— 日级宜忌。
- [婚庆搬家择日场景：组合黄历+吉神凶煞+吉时做择日推荐](https://www.showapi.com/guides/huangli-date-selection-856) —— 多接入点联动。
- **本系列共 11 篇**：查看[黄历运势指南总目录](https://www.showapi.com/guides/huangli-guides-856)
