黄历运势婚庆搬家择日场景：组合黄历+吉神凶煞+吉时做择日推荐
# 黄历运势婚庆搬家择日场景：组合黄历+吉神凶煞+吉时做择日推荐
> 接口 黄历运势（apiCode=856） · 免费服务 · 适用人群：婚庆/搬家/礼仪类应用开发者 · 阅读时间约 8 分钟
## TL;DR
- 三个接入点相互独立，需分别调用：856-2（日级宜忌）、856-4（神煞方位）、856-3（时辰吉凶）。
- 择日推荐的典型流程：先用 856-2 筛「宜嫁娶/宜移徙」的日期 → 用 856-4 取方位与犯太岁 → 用 856-3 取当日吉时。
- 接口只给数据、不给「吉凶结论」，最终判定口径由你的产品定义，避免替用户下绝对结论。
## Why：择日类功能为什么要多接入点联动
用户问「哪天结婚好」「几点搬家吉利」，单看黄历的「宜/忌」不够——还要知道当天神煞方位（避开岁破）、是否冲犯太岁生肖、以及具体吉时。这正好对应 856-2 / 856-4 / 856-3 三个接入点的能力。本文给出一个可落地的组合方案。
## What：三接入点分工
| 接入点 | 解决 | 关键字段 |
|--------|------|----------|
| 856-2 黄历 | 这天「宜/忌」什么 | `yi`、`ji`、`chongsha`、`zhishen` |
| 856-4 吉神凶煞 | 神煞方位、犯太岁、推荐吉时 | `caishen`、`xishen`、`fantaisui`、`tjjs` |
| 856-3 吉时 | 当天各时辰吉凶 | 12 时辰对象的 `jixiong`/`shijian` |
> 字段详情见 [黄历运势返回字段全解](https://www.showapi.com/guides/huangli-response-fields-856)。
## How：一次择日查询的组合实现
### 步骤 1：并发调用三个接入点
**Python（requests）**
```python
import requests
from concurrent.futures import ThreadPoolExecutor
APPKEY = "YOUR_APPKEY"
YMD = "20260211"
BASE = "https://route.showapi.com"
def call(point):
url = f"{BASE}/{point}"
r = requests.get(url, params={"appKey": APPKEY, "ymd": YMD}, timeout=10)
b = r.json().get("showapi_res_body", {})
return point, b if b.get("ret_code") == 0 else None
with ThreadPoolExecutor() as ex:
results = dict(ex.map(call, ["856-2", "856-4", "856-3"]))
almanac = results.get("856-2") # 黄历
deities = results.get("856-4") # 吉神凶煞
hours = results.get("856-3") # 吉时
if almanac and deities and hours:
print("宜：", almanac.get("yi"))
print("忌：", almanac.get("ji"))
print("冲煞：", almanac.get("chongsha"))
print("财神：", deities.get("caishen"), "| 喜神：", deities.get("xishen"))
print("犯太岁生肖：", deities.get("fantaisui"))
# 取吉时
order = ["zi","chou","yin","mao","chen","si","wu","wei","shen","you","xu","hai"]
lucky = [hours[k]["shijian"] for k in order if "吉" in hours.get(k, {}).get("jixiong", "")]
print("吉时：", lucky)
```
**cURL（分别调用三个地址）**
```bash
curl "https://route.showapi.com/856-2?appKey=YOUR_APPKEY&ymd=20260211"
curl "https://route.showapi.com/856-4?appKey=YOUR_APPKEY&ymd=20260211"
curl "https://route.showapi.com/856-3?appKey=YOUR_APPKEY&ymd=20260211"
```
**Node.js（fetch，Promise.all）**
```js
const APPKEY = "YOUR_APPKEY", YMD = "20260211";
const pts = ["856-2","856-4","856-3"];
const data = await Promise.all(pts.map(p =>
fetch(`https://route.showapi.com/${p}?appKey=${APPKEY}&ymd=${YMD}`).then(r => r.json())
.then(d => d.showapi_res_body)));
const [almanac, deities, hours] = data;
console.log("宜:", almanac.yi, "| 财神:", deities.caishen, "| 犯太岁:", deities.fantaisui);
```
### 步骤 2：做成「择日评分」
把三路数据按你的业务规则加权（如：宜嫁娶 +分、冲煞 -分、犯太岁生肖命中 -分、有吉时 +分），输出排序后的候选日期列表。规则由你定义，接口不提供「吉凶分数」。
## 进阶 / 边界
- **接口不替你下结论**：三个接入点都只返回数据（宜忌、方位、吉凶标签），「这天好不好」的判定是你的产品逻辑，务必注明口径，避免绝对化表述。
- **日期范围限制**：仅支持 1901-01-01 至当前年份，择日区间需在此范围内。
- **调用次数**：三个接入点各算一次调用，建议在用户「确认查询」时再并发调用，并做按日缓存（见 [缓存策略](https://www.showapi.com/guides/huangli-cache-cost-856)）。
## FAQ
**Q1：能不能一次返回三个接入点的数据，少调几次？**
A：不能，三个接入点是独立接口地址，需分别调用。可用并发（如上）把总耗时压到一次往返。
**Q2：推荐的「吉时」用哪个接入点？**
A：856-3 给逐时辰吉凶全量；856-4 的 `tjjs` 给一个推荐地支列表。二者口径不同，可组合或任选其一。
**Q3：犯太岁生肖怎么用？**
A：`fantaisui`（如「鼠、马、羊、兔」）是当年犯太岁生肖，可在用户填写生肖后做命中提醒，属年度维度。
## 相关能力 / 下一步阅读
- [黄历查询接入点详解：宜忌、冲煞、值神怎么用](https://www.showapi.com/guides/huangli-day-almanac-856) —— 856-2 字段落地。
- [吉神凶煞查询接入点：财神喜神方位与择日应用](https://www.showapi.com/guides/huangli-deities-856) —— 856-4 方位实战。
- [吉时查询接入点：如何给用户推荐当日吉时](https://www.showapi.com/guides/huangli-auspicious-hours-856) —— 856-3 时辰解析。
- [免费接口如何做缓存：黄历运势按日期缓存省调用次数](https://www.showapi.com/guides/huangli-cache-cost-856) —— 控制调用量。
- **本系列共 11 篇**：查看[黄历运势指南总目录](https://www.showapi.com/guides/huangli-guides-856)
