| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
61 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_6af4348cb62375492af22bdbf006800b |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
travelerName |
string | 是 | 出行人姓名 | |
travelerBirthday |
string | 是 | 出行人生日,格式 YYYY-MM-DD | |
travelerHour |
integer | 是 | 出行人出生时辰(0-23 整数) | |
range |
string | 否 | 时间范围:1month(默认)、3months、6months、1year | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
返回参数见接口详情 |
string | 返回参数见接口详情 | |
{"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":"出行人的姓名不能为空"}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
400 |
400 | invalid_name | 姓名未填写 |
400 |
400 | invalid_birthday | 生日格式错误,请使用 YYYY-MM-DD |
400 |
400 | invalid_hour | 出生时辰未填写或不在 0-23 范围内 |
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
接口免责声明
1、本接口仅实现传统国学数理学体系数理运算,输出原始演算数据,供传统文化爱好者技术研究使用;
2、所有演算结果仅供娱乐参考,不代表客观事实,不构成事业、投资、婚恋、择事等任何人生决策建议;
3、下游调用方不得利用接口数据开展封建迷信宣传、有偿测算、有偿择吉等违规业务;
4、因调用方滥用接口、过度依赖测算结果引发的一切损失,逗号API平台不承担任何相关责任。
5、所有结果都是依据国学书籍来进行演算,可能部分书籍原始资料有误,若遇到不对的地方,联系客服指正修改!
| 字段 | 类型 | 说明 |
|---|---|---|
| data.persons[0].name | string | 出行人姓名(原样返回) |
| data.persons[0].birthday | string | 出行人生日 |
| data.persons[0].hour | int | 出行人出生时辰 |
| data.persons[0].bazi | string | 出行人四柱八字 |
| data.persons[0].animal | string | 出行人生肖 |
| data.persons[0].nayin | string | 出行人日柱纳音 |
| data.persons[0].avoid.zhi | string | 出行人需避开的地支 |
| data.persons[0].avoid.animal | string | 出行人需避开的生肖 |
| data.persons[0].avoid.sha | string | 出行人需避开的煞方 |
| 字段 | 类型 | 说明 |
|---|---|---|
| data.range.start | string | 起始日期 YYYY-MM-DD(今天) |
| data.range.end | string | 结束日期 YYYY-MM-DD |
| data.range.range | string | 时间范围标识 |
| 字段 | 类型 | 说明 |
|---|---|---|
| data.goodDays[].date | string | 吉日日期 YYYY-MM-DD |
| data.goodDays[].lunar.lunarYear | int | 农历年 |
| data.goodDays[].lunar.lunarMonth | int | 农历月 |
| data.goodDays[].lunar.lunarDay | int | 农历日 |
| data.goodDays[].dayGZ | string | 当日干支 |
| data.goodDays[].chong.animal | string | 冲煞生肖 |
| data.goodDays[].chong.zhi | string | 冲煞地支 |
| data.goodDays[].chong.sha | string | 煞方 |
| data.goodDays[].yi | array | 宜事列表(老黄历关键词:出行) |
| data.goodDays[].ji | array | 忌事列表(同上替换规则) |
| data.goodDays[].zhiShen.name | string | 值神名称 |
| data.goodDays[].zhiShen.type | string | 值神类型(一定是「黄道」) |
| data.goodDays[].star.name | string | 二十八星宿 |
| data.goodDays[].star.yi | array | 星宿宜事 |
| data.goodDays[].star.ji | array | 星宿忌事 |
| data.goodDays[].jianChu | string | 十二建除 |
| data.goodDays[].caishen | string | 财神/福神/喜神方位 |
| data.goodDays[].taishen | string | 胎神方位 |
| data.goodDays[].festivals | array | 节日列表 |
| data.goodDays[].comment | string | 该日对应类别的六十甲子评语 |
| data.goodDays[].starDesc | string | 该日星宿在该吉日类别下的表现文字 |
浙公网安备 33059102000262号