传统八字-八字排盘（新版）
文档说明
接口重构与版本说明：
1. 标准数据结构重构：本接口为八字排盘核心能力的重构标准版。在延续核心排盘计算能力的基础上，对历史版本的数据组织方式进行了重新设计，采用四柱独立对象（year / month / day / hour）及结构化 JSON 数据，使字段层级更加统一，便于程序直接处理、前端展示以及 LLM / AI 应用集成。
2. 排盘能力集成：本接口提供完整的四柱排盘信息，并集成神煞、格局、五行量化与喜用神分析、起运及童限（出生至起运阶段）、大运与流年等数据，可用于常规八字排盘展示及相关规则计算。
3. 历史版本兼容：平台原有 【八字排盘（旧版）】 作为历史兼容接口继续保留并持续维护，已有项目无需强制迁移。
1. 标准数据结构重构：本接口为八字排盘核心能力的重构标准版。在延续核心排盘计算能力的基础上，对历史版本的数据组织方式进行了重新设计，采用四柱独立对象（year / month / day / hour）及结构化 JSON 数据，使字段层级更加统一，便于程序直接处理、前端展示以及 LLM / AI 应用集成。
2. 排盘能力集成：本接口提供完整的四柱排盘信息，并集成神煞、格局、五行量化与喜用神分析、起运及童限（出生至起运阶段）、大运与流年等数据，可用于常规八字排盘展示及相关规则计算。
3. 历史版本兼容：平台原有 【八字排盘（旧版）】 作为历史兼容接口继续保留并持续维护，已有项目无需强制迁移。
将出生年月日时转换为四柱干支，并提供结构化的四柱信息、神煞、格局、五行量化与喜用神分析、起运、童限以及大运流年等排盘数据，可直接用于命理排盘展示、数据处理及 AI 应用。
与【八字精盘】的功能边界：
本接口定位为标准化八字排盘接口，重点提供结构化四柱原盘及大运、流年等标准排盘数据。如果业务需要进一步展开更细的时序数据，以及更多传统命理扩展参数，可使用 【传统八字-八字精盘】。精盘主要在本接口基础上进一步扩展：
• 更细的时序数据：流月、逐年小运，以及流年节气交节时间等；
• 更多传统命理参数：月令司令、五行旺度、盲派口诀交运、二十八星宿、命卦方位，以及天干地支合冲刑害等关系数据；
• 胎元、胎息、命宫、身宫的深度展开：提供相应干支及藏干、十神、长生、神煞等更完整的数据实体。
请求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Bazi/pan请求头
| 字段 | 类型 | 描述 |
|---|---|---|
| Content-Type | String | application/x-www-form-urlencoded |
请求参数
| 字段 | 类型 | 描述 |
|---|---|---|
| api_key | String | 密钥 |
| name | String | 姓名 |
| sex | Int | 性别 0：男 1：女 |
| type | Int |
历类型 0：农历 1：公历
建议：对于农历，若出生年包含闰月或需极高精度时，强烈推荐先调用【基础工具-阴阳历互相转换】获取公历，再以 type=1 传入。
|
| year | Int | 出生年 例: 1988 |
| month | Int | 出生月 例: 8
注意：本接口不处理闰月。若该年存在闰月，请通过转换工具获取公历后再行带入。
|
| day | Int | 出生日 例: 7 |
| hours | Int | 出生时 例: 12 |
| minute | Int | 出生分 例: 30 如果不知道具体分，可以传数字 0 |
| sect | Int | 流派 例：1：晚子时日柱算明天 2：晚子时日柱算当天 非必传，如果不传递这个参数，默认2 |
| zhen | Int | 是否使用真太阳时 例： 1：使用中国真太阳时(需传省和市) 2：不使用真太阳时 3：使用全球真太阳时(需传经纬度) 非必传，如果不传递这个参数，默认2 |
| province | String | 省 例：北京市 非必传，但若 zhen=1，则省与市皆为必传参数。点击此处了解省市列表 |
| city | String | 市 例：北京 非必传，但若 zhen=1，则省与市皆为必传参数。点击此处了解省市列表 |
| longitude | float | 十进制经度 例：-77.036871 非必传，但若 zhen=3，则经度与纬度皆为必传参数。 |
| latitude | float | 十进制纬度 例：38.907192 非必传，但若 zhen=3，则经度与纬度皆为必传参数。 |
| timezone | string |
时区（IANA 格式），例：Asia/Shanghai
非必传，默认 Asia/Shanghai
|
| lang | String | 多语言：zh-cn 、zh-tw 非必传，如果不传递这个参数，默认为 zh-cn |
请求参数示例
$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'name' => '张三',
'sex' => '1',
'type' => '1',
'year' => '1988',
'month' => '11',
'day' => '8',
'hours' => '12',
'minute' => '20',
'zhen' => '3',
'longitude' => '-77.036871',
'latitude' => '38.907192',
];返回参数
| 字段 | 类型 | 描述 |
|---|---|---|
| errcode | String | 请求状态码 0成功 其它为失败 |
| errmsg | String | 状态码说明 |
| notice | String | 声明 |
| data | Json | 数据信息 |
成功返回示例
{
"errcode": 0,
"errmsg": "请求成功",
"notice": "本次测算结果仅供娱乐使用，请勿用于封建迷信和违法用途。",
"data": {
"base_info": {
"zhen": { //考虑真太阳时才会有此字段，不考虑真太阳时就没有这个字段
"province": "--", //真太阳时省份，若为全球真太阳时(zhen=3)则不展示具体省市
"city": "--", //真太阳时城市
"jingdu": "-77.04",//真太阳时经度
"weidu": "38.91", //真太阳时纬度
"shicha": "晚12小时51分55秒" //本地时间相对于真太阳时的时差
},
"sex": "坤造",
"name": "章三",
"gongli": "1988-11-07 23:28:00", //公历（若考虑真太阳时，此处为校正后的公历）
"nongli": "一九八八年九月廿八日 子时", //农历（若考虑真太阳时，此处为校正后的农历）
"qiyun": "0年1个月23天后起运", //起运时间
"jiaoyun": "1988-12-31 07:28:00后交运", //交运时间
"taiyuan": "甲寅", //胎元
"taiyuan_nayin": "大溪水", //胎元纳音
"taixi": "辛亥", //胎息
"taixi_nayin": "钗钏金", //胎息纳音
"minggong": "戊午", //命宫
"minggong_nayin": "天上火", //命宫纳音
"shengong": "甲子", //身宫
"shengong_nayin": "海中金", //身宫纳音
"shengxiao": "龙", //生肖
"xingzuo": "天蝎", //星座
"zhengge": "七杀格", //八字正格
"xiyongshen": { //喜用神量化分析（基于五行量化算法）
"qiangruo": "八字偏弱", //八字强弱判定
"xiyongshen": "木，火", //喜用神
"jishen": "水", //忌神
"xiyongshen_desc": "身弱，需补助，避免克泄耗，喜用木补火，避土忌水金。", //喜用神指导建议
"jin_number": 1, //五行统计：金的个数
"mu_number": 1, //五行统计：木的个数
"shui_number": 3, //五行统计：水的个数
"huo_number": 1, //五行统计：火的个数
"tu_number": 2, //五行统计：土的个数
"zidang": 1, //自党得分
"yidang": 8, //异党得分
"zidang_percent": "11.11%", //自党占比
"yidang_percent": "88.89%", //异党占比
"tonglei": "木火", //同类五行
"yilei": "金水土", //异类五行
"rizhu_tiangan": "火", //命主日元五行
"jin_score": 36, //五行金能量分数
"mu_score": 32, //五行木能量分数
"shui_score": 85,//五行水能量分数
"huo_score": 43, //五行火能量分数
"tu_score": 68, //五行土能量分数
"jin_score_percent": "13.64%", //五行金能量占比
"mu_score_percent": "12.12%", //五行木能量占比
"shui_score_percent": "32.2%", //五行水能量占比
"huo_score_percent": "16.29%", //五行火能量占比
"tu_score_percent": "25.76%", //五行土能量占比
"yinyang": "偏阳" //五行阴阳倾向参考
},
"wuxing_xiji": "喜火 用木 闲土 仇金 忌水" //五行喜忌速览
},
"detail_info": {
"dayun_info": [
{
"dayun_index": 1, //第1步大运序号(1-9)
"dayun_start_year": 1988, //大运起始年份（含）
"dayun_start_age": 1, //大运起始虚岁（含）
"dayun_end_year": 1997, //大运结束年份（含）
"dayun_end_age": 10, //大运结束虚岁（含）
"dayun_start_ganzhi": "壬戌", //大运干支
"dayun_xun": "甲寅", //大运所在旬
"dayun_kongwang": "子丑", //大运空亡
"dayun_shishen": "七杀", //大运主星十神
"dayun_changsheng": "墓", //大运地支十二长生
"dayun_year_tg": "壬", //大运天干
"dayun_year_dz": "戌", //大运地支
"dayun_year_cg": ["戊", "辛", "丁"], //大运地支藏干
"dayun_year_tg_god": "七杀", //大运天干十神
"dayun_year_dz_god": ["食神", "正财", "劫财"], //大运地支藏干十神
"dayun_dz_star_cs": "墓", //星运（十二长生）
"dayun_dz_self_cs": "冠带", //自坐（十二长生）
"dayun_nayin": "大海水", //大运纳音五行
"dayun_wuxing": "水土", //大运干支五行属性
"dayun_tg_liuyi": "壬丙相冲 壬丙相克 庚癸相生 丙庚相克", //大运天干合化冲克关系
"dayun_dz_liuyi": "寅戌半合火局 寅亥合化木", //大运地支刑冲破害合化关系
"liunian_info": [ //当前大运对应的10个流年时序（固定10年数组）
{
"liunian_index": 0, //流年在大运中的索引（0-9）
"liunian_year": 1988, //流年公历年份
"liunian_age": 1, //流年对应虚岁
"liunian_ganzhi": "戊辰" //流年天干地支
},
{
"liunian_index": 1,
"liunian_year": 1989,
"liunian_age": 2,
"liunian_ganzhi": "己巳"
},
// ... 此处省略第 3 至第 9 个流年 ...
{
"liunian_index": 9,
"liunian_year": 1997,
"liunian_age": 10,
"liunian_ganzhi": "丁丑"
}
],
"dayun_shensha": "德秀贵人 天医 华盖 日德 空亡" //大运所临神煞
},
// ... 此处省略第 2 至第 9 步大运（数据结构与第 1 步完全一致） ...
{
"dayun_index": 10,
"dayun_start_year": 2078,
"dayun_start_age": 91,
"dayun_end_year": 2087,
"dayun_end_age": 100,
"dayun_start_ganzhi": "癸丑",
"dayun_shishen": "正官",
"dayun_changsheng": "衰",
// ... 内部字段同上 ...
"dayun_shensha": "天乙贵人 太极贵人 华盖"
}
],
"dayun_born_info": { //童限信息（出生后至起运前阶段）
"dayun_index": 0,
"dayun_start_year": 1988,
"dayun_start_age": 1,
"dayun_end_year": 1988,
"dayun_end_age": 1,
"dayun_start_ganzhi": "癸亥",
"dayun_xun": "甲寅",
"dayun_kongwang": "子丑",
"dayun_shishen": "正官",
"dayun_changsheng": "绝",
"dayun_year_tg": "癸",
"dayun_year_dz": "亥",
"dayun_year_cg": ["壬", "甲"],
"dayun_year_tg_god": "正官",
"dayun_year_dz_god": ["七杀", "偏印"],
"dayun_dz_star_cs": "绝",
"dayun_dz_self_cs": "帝旺",
"dayun_nayin": "大海水",
"dayun_wuxing": "水水",
"dayun_tg_liuyi": "庚癸相生 丙庚相克",
"dayun_dz_liuyi": "亥亥自刑 寅亥合化木",
"liunian_info": [
{
"liunian_index": 0,
"liunian_year": 1988,
"liunian_age": 1,
"liunian_ganzhi": "戊辰"
}
]
},
"sizhu_info": { //四柱标准对象（年月日时）
"year": { //年柱
"tg_god": "食神", //天干十神（主星）
"tg": "戊", //天干
"dz": "辰", //地支
"cg": ["戊", "乙", "癸"], //地支藏干
"dz_god": ["食神", "正印", "正官"], //藏干十神（副星）
"dz_star_cs": "冠带", //星运（地支十二长生）
"dz_self_cs": "冠带", //自坐（天干坐地支十二长生）
"kw": "戌亥", //该柱旬空（空亡）
"ny": "大林木", //纳音五行
"wx": "土土", //干支五行属性
"xun": "甲子", //所属旬空
"shensha": "太极贵人 日德" //该柱所临吉神凶煞
},
"month": { //月柱
"tg_god": "正官",
"tg": "癸",
"dz": "亥",
"cg": ["壬", "甲"],
"dz_god": ["七杀", "偏印"],
"dz_star_cs": "绝",
"dz_self_cs": "帝旺",
"kw": "子丑",
"ny": "大海水",
"wx": "水水",
"xun": "甲寅",
"shensha": "天乙贵人 学堂 红鸾 血刃 劫煞 亡神 空亡"
},
"day": { //日柱（日元命主）
"tg_god": "日主",
"tg": "丙",
"dz": "寅",
"cg": ["甲", "丙", "戊"],
"dz_god": ["偏印", "比肩", "食神"],
"dz_star_cs": "长生",
"dz_self_cs": "长生",
"kw": "戌亥",
"ny": "炉中火",
"wx": "火木",
"xun": "甲子",
"shensha": "福星贵人 词馆 驿马 红艳煞 天狗 吊客"
},
"hour": { //时柱
"tg_god": "偏财",
"tg": "庚",
"dz": "子",
"cg": ["癸"],
"dz_god": ["正官"],
"dz_star_cs": "胎",
"dz_self_cs": "死",
"kw": "辰巳",
"ny": "壁上土",
"wx": "金水",
"xun": "甲午",
"shensha": "天德合 福星贵人 将星 飞刃"
}
}
}
}
}
失败返回示例
{
"errcode": -1,
"errmsg": "日期有误",
}