八字排盘 天干地支API接口文档 GET / POST 娱乐测试

八字排盘API提供公历日期转八字干支的服务。输入出生年月日时，返回完整的八字四柱、十神、五行、纳音等数据。（提示：本API排盘数据源自传统国学理论计算的结果，仅供娱乐参考，使用请看接口详情声明。）

请求 GET / POST返回 application/json1 积分 / 次上线 2026-09-24 14:57:41

八字排盘API提供公历日期转八字干支的服务。输入出生年月日时，返回完整的八字四柱、十神、五行、纳音等数据。（提示：本API排盘数据源自传统国学理论计算的结果，仅供娱乐参考，使用请看接口详情声明。）

1 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=bazi
方法
GET / POST
分类
娱乐测试
计费
1 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

八字排盘 天干地支接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=bazi
请求方式：
GET / POST
返回格式：
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=bazi

apikey=你的API密钥&year=请填写year&month=请填写month&day=请填写day&hour=请填写hour

GET 参数放在查询字符串中。参数值请替换为实际有效值。

八字排盘 天干地支请求参数

参数名类型必填说明示例
yearinteger是出生年份，范围1900-2100
monthinteger是出生月份，1-12
dayinteger是出生日期，1-31
hourinteger是出生小时（0-23），如12=午时
返回示例
{"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"}}

详细文档

八字排盘 天干地支 API 接口文档

接口描述

八字排盘API提供公历日期转八字干支的服务。输入出生年月日时，返回完整的八字四柱、十神、五行、纳音等数据。（提示：本API排盘数据源自传统国学理论计算的结果，仅供娱乐参考，使用请看接口详情声明。）

功能特性

  • 八字排盘API提供公历日期转八字干支的服务。输入出生年月日时，返回完整的八字四柱、十神、五行、纳音等数据。（提示：本AP…
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

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

请求方式

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

鉴权方式

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

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

请求参数

参数名 类型 必填 描述
year integer 是 出生年份，范围1900-2100
month integer 是 出生月份，1-12
day integer 是 出生日期，1-31
hour integer 是 出生小时（0-23），如12=午时

请求参数 (JSON格式)

[
  {"name": "year", "type": "integer", "required": true, "description": "出生年份，范围1900-2100"},
  {"name": "month", "type": "integer", "required": true, "description": "出生月份，1-12"},
  {"name": "day", "type": "integer", "required": true, "description": "出生日期，1-31"},
  {"name": "hour", "type": "integer", "required": true, "description": "出生小时（0-23），如12=午时"}
]

响应格式

JSON 格式响应

成功返回示例：

{"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密钥"}

返回参数说明

参数名 类型 说明
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,...}

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=bazi?key=SK-你的密钥&year=1995&month=6&day=15&hour=12"

错误响应

上游业务级错误：

code msg 描述
400 invalid_year 年份超出范围
400 invalid_month 月份超出范围
400 invalid_day 日期超出范围
400 invalid_hour 小时超出范围
400 invalid_date 日期不存在
401 invalid_api_key API密钥无效
500 calculation_failed 计算失败

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

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

注意事项

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

开发时间

2026-09-24