出行吉日查询 API 接口文档

接口描述

输入出行人姓名、出生日期、时辰，基于协纪辨方书干支轮值算法，并结合查询人生辰八字、生肖冲煞、黄道值神进行筛选适合出行的黄道吉日。（结果仅供娱乐参考）

功能特性

• 输入出行人姓名、出生日期、时辰，基于协纪辨方书干支轮值算法，并结合查询人生辰八字、生肖冲煞、黄道值神进行筛选适合出行的黄…
• 返回 JSON 结构化数据，便于程序解析
• 支持 GET / POST 两种调用方式
• 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=chuxingday

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

• URL 参数：key=SK-你的密钥
• 或请求头：X-API-Key: SK-你的密钥

请求参数

请求参数 (JSON格式)

[
  {"name": "travelerName", "type": "string", "required": true, "description": "出行人姓名"},
  {"name": "travelerBirthday", "type": "string", "required": true, "description": "出行人生日，格式 YYYY-MM-DD"},
  {"name": "travelerHour", "type": "integer", "required": true, "description": "出行人出生时辰（0-23 整数）"},
  {"name": "range", "type": "string", "required": false, "description": "时间范围：1month（默认）、3months、6months、1year"}
]

响应格式

JSON 格式响应

成功返回示例：

{"success":true,"data":{"persons":[{"name":"李华","birthday":"2006-07-07","hour":1,"bazi":"丙戌 乙未 丁酉 辛丑","animal":"狗","nayin":"山下火","avoid":{"zhi":"辰","animal":"龙","sha":"北"}}],"range":{"start":"2026-09-12","end":"2026-10-12","range":"1month"},"goodDays":[{"date":"2026-09-14","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":4},"dayGZ":"辛卯","chong":{"zhi":"酉","animal":"鸡","sha":"西"},"yi":["纳采","订盟","开市","出行","入宅","安床","祭祀","上梁","破屋","坏垣","解除"],"ji":["裁衣","安葬"],"zhiShen":{"name":"明堂","type":"黄道"},"star":{"name":"房宿","yi":["嫁娶","纳采","订盟","开市","出行","入宅","安床","祭祀","上梁"],"ji":["裁衣"]},"jianChu":"破","caishen":"财神：正东、福神：西北、喜神：西南","taishen":"大门外正东","festivals":[]},{"date":"2026-09-17","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":7},"dayGZ":"甲午","chong":{"zhi":"子","animal":"鼠","sha":"北"},"yi":["祭祀","祈福","建造","纳采","订盟","移徙","出行","斋醮","塑绘","开光","安香","出火","会亲友","解除","入学","竖柱","上梁","拆卸","盖屋","起基","栽种","牧养","纳畜"],"ji":["开市","安床","动土","裁衣","安葬","破土","开仓","出货财","启钻"],"zhiShen":{"name":"金匮","type":"黄道"},"star":{"name":"箕宿","yi":["建造","祭祀","祈福"],"ji":["嫁娶","开市","入宅","安床","动土","裁衣"]},"jianChu":"收","caishen":"财神：东北、福神：正北、喜神：东北","taishen":"房床碓外正南","festivals":[]},{"date":"2026-09-20","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":10},"dayGZ":"丁酉","chong":{"zhi":"卯","animal":"兔","sha":"东"},"yi":["祭祀","出行","纳财","祈福","裁衣","冠笄","交易","雕刻","造畜稠","造车器","教牛马"],"ji":["入宅","开市","安床","远行","移徙","栽种","动土","破土","作灶","安葬","行丧","伐木","上梁"],"zhiShen":{"name":"玉堂","type":"黄道"},"star":{"name":"虚宿","yi":["祭祀","祈福","出行","纳财"],"ji":["嫁娶","开市","入宅","安床","远行"]},"jianChu":"建","caishen":"财神：正西、福神：东南、喜神：正南","taishen":"大门外正西","festivals":[]},{"date":"2026-09-23","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":13},"dayGZ":"庚子","chong":{"zhi":"午","animal":"马","sha":"南"},"yi":["嫁娶","纳采","开市","交易","出行","入宅","修造","建造","祭祀","畋猎","结网"],"ji":["安葬","破土","治病","开渠"],"zhiShen":{"name":"司命","type":"黄道"},"star":{"name":"壁宿","yi":["嫁娶","纳采","开市","交易","出行","入宅","修造","动土","建造"],"ji":["安葬"]},"jianChu":"平","caishen":"财神：正东、福神：西南、喜神：西北","taishen":"房床碓外正北","festivals":["秋分"]},{"date":"2026-09-26","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":16},"dayGZ":"癸卯","chong":{"zhi":"酉","animal":"鸡","sha":"西"},"yi":["纳采","开市","交易","出行","入宅","修造","破屋","坏垣","解除"],"ji":[],"zhiShen":{"name":"明堂","type":"黄道"},"star":{"name":"胃宿","yi":["嫁娶","纳采","开市","交易","出行","入宅","修造","安葬"],"ji":[]},"jianChu":"破","caishen":"财神：正南、福神：东北、喜神：东南","taishen":"大门外正东","festivals":[]},{"date":"2026-09-29","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":19},"dayGZ":"丙午","chong":{"zhi":"子","animal":"鼠","sha":"北"},"yi":["祭祀","祈福","纳采","订盟","移徙","出行","斋醮","塑绘","开光","安香","出火","会亲友","解除","入学","竖柱","上梁","拆卸","盖屋","起基","栽种","牧养","纳畜"],"ji":["开市","安葬","安床","动土","建造","破土","开仓","出货财","启钻"],"zhiShen":{"name":"金匮","type":"黄道"},"star":{"name":"觜宿","yi":["祭祀","祈福"],"ji":["嫁娶","开市","入宅","安床","动土","建造","安葬"]},"jianChu":"收","caishen":"财神：正西、福神：西北、喜神：西南","taishen":"房床碓外正南","festivals":[]},{"date":"2026-10-02","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":22},"dayGZ":"己酉","chong":{"zhi":"卯","animal":"兔","sha":"东"},"yi":["祭祀","祈福","出行","裁衣","冠笄","交易","雕刻","纳财","造畜稠","造车器","教牛马"],"ji":["入宅","动土","开市","安床","远行","建造","移徙","栽种","破土","作灶","行丧","伐木","上梁"],"zhiShen":{"name":"玉堂","type":"黄道"},"star":{"name":"鬼宿","yi":["祭祀","祈福","安葬"],"ji":["嫁娶","开市","入宅","安床","动土","远行","建造"]},"jianChu":"建","caishen":"财神：正北、福神：正北、喜神：东北","taishen":"大门外正西","festivals":[]}]},"generated_at":"2026-09-12 09:32:54"}

失败返回示例：

{"success":false,"error":"invalid_name","message":"出行人的姓名不能为空"}

返回参数说明

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=chuxingday?key=SK-你的密钥&travelerName=%E5%BC%A0%E4%BC%9F&travelerBirthday=1992-11-11&travelerHour=6"

错误响应

上游业务级错误：

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

• 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
• 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
• 请合理控制调用频率，避免高频恶意调用触发风控
• 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24