八字排盘API提供公历日期转八字干支的服务。输入出生年月日时,返回完整的八字四柱、十神、五行、纳音等数据。(提示:本API仅为日历天干地支转换,仅供娱乐参考,切勿用于传播迷信。)
| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
9 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_ac41045cf50bb5f24a72100eda19d283 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
year |
integer | 是 | 出生年份,范围1900-2100 | |
month |
integer | 是 | 出生月份,1-12 | |
day |
integer | 是 | 出生日期,1-31 | |
hour |
integer | 是 | 出生小时(0-23),如12=午时 | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
success |
boolean | 请求是否成功 | |
data |
object | 排盘结果数据 | |
generated_at |
string | 数据生成时间 | |
data.input |
object | 输入参数回显 | |
data.input.year |
integer | 公历年份 | |
data.input.month |
integer | 公历月份 | |
data.input.day |
integer | 公历日期 | |
data.input.hour |
integer | 小时数 | |
data.input.hour_name |
string | 时辰名称(子时/丑时等) | |
data.bazi |
string | 八字四柱字符串(如"庚午 壬午 辛亥 甲午") | |
data.columns[].column |
string | 柱名(年柱/月柱/日柱/时柱) | |
data.columns[].ganzhi |
string | 干支组合(如"庚午") | |
data.columns[].tian_gan |
string | 天干 | |
data.columns[].di_zhi |
string | 地支 | |
data.columns[].main_star |
string | 主星/十神(日柱固定为"日主") | |
data.columns[].cang_gan |
array | 藏干天干列表(如["丁","己"]) | |
data.columns[].sub_stars |
array | 副星/藏干十神列表(与cang_gan一一对应) | |
data.columns[].di_shi |
string | 地势/十二长生(长生/沐浴/冠带/临官/帝旺/衰/病/死/墓/绝/胎/养) | |
data.columns[].kong_wang |
boolean | 该柱是否空亡 | |
data.columns[].na_yin |
string | 纳音五行(如"路旁土") | |
data.summary.ri_gan |
string | 日干(日主天干) | |
data.summary.ri_wu_xing |
string | 日主五行(金/木/水/火/土) | |
data.summary.yue_zhi |
string | 月令地支 | |
data.summary.kong_wang |
string | 空亡地支(如"寅、卯空") | |
data.wu_xing.scores |
object | 五行加权分数 {"木":0,"火":40,"土":12,"金":27,"水":11} | |
data.wu_xing.wang_shuai |
object | 五行旺衰判断 {"木":"偏弱","火":"偏旺",...} | |
data.wu_xing.percentages |
object | 五行占比(%){"木":0,"火":44.4,...} | |
{"success":true,"data":{"bazi":"庚午 壬午 辛亥 癸巳","birth":{"year":1990,"month":6,"day":15,"hour":10,"hour_name":"巳时","date_str":"1990年6月15日"},"pillars":{"year":{"gan":"庚","zhi":"午","gan_shishen":"劫财","zhi_shishen":"七杀","wuxing":"金火","nayin":"路旁土"},"month":{"gan":"壬","zhi":"午","gan_shishen":"伤官","zhi_shishen":"七杀","wuxing":"水火","nayin":"杨柳木"},"day":{"gan":"辛","zhi":"亥","gan_shishen":"日元","zhi_shishen":"伤官","wuxing":"金水","nayin":"钗钏金"},"hour":{"gan":"癸","zhi":"巳","gan_shishen":"食神","zhi_shishen":"正官","wuxing":"水火","nayin":"长流水"}},"rizhu":{"ri_gan":"辛","ri_wuxing":"金","yue_zhi":"午"},"wuxing":{"score":{"木":0,"火":24,"土":0,"金":20,"水":10},"wangshuai":{"木":"偏弱","火":"偏旺","土":"偏弱","金":"中和","水":"中和"},"percent":{"木":0,"火":44.4,"土":0,"金":37,"水":18.5}},"generated_at":"2026-07-29 20:00:00"}}
HTTP/1.1 401 Unauthorized
{"success":false,"error":"invalid_api_key","message":"认证失败,请提供有效的API密钥"}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
400 |
400 | invalid_year | 年份超出范围 |
400 |
400 | invalid_month | 月份超出范围 |
400 |
400 | invalid_day | 日期超出范围 |
400 |
400 | invalid_hour | 小时超出范围 |
400 |
400 | invalid_date | 日期不存在 |
401 |
400 | invalid_api_key | API密钥无效 |
500 |
400 | calculation_failed | 计算失败 |
| 错误代码 | 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 | 服务器内部错误 | 系统异常 |
免责声明
浙公网安备 33059102000262号