傳統八字-八字排盤（新版）
文件說明
接口重構與版本說明：
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請求標頭 (Headers)
| 欄位 | 型別 | 描述 |
|---|---|---|
| Content-Type | String | application/x-www-form-urlencoded |
請求參數
| 欄位 | 型別 | 描述 |
|---|---|---|
| api_key | String | 存取金鑰 (API Key) |
| name | String | 姓名 |
| sex | Int | 性別 0：男 1：女 |
| type | Int |
曆法類型 0：農曆 1：公曆
建議：對於農曆，若出生年包含閏月或需極高精度時，強烈推薦先呼叫【基礎工具-陰陽曆互相轉換】獲取公曆，再以 type=1 傳入。
|
| year | Int | 出生年 例: 1988 |
| month | Int | 出生月 例: 8
注意：本API不處理閏月。若該年存在閏月，請通過轉換工具獲取公曆後再行帶入。
|
| day | Int | 出生日 例: 7 |
| hours | Int | 出生時 例: 12 |
| minute | Int | 出生分 例: 30 如果不知道具體分，可以傳數字 0 |
| sect | Int | 流派 例：1：晚子時日柱算明天 2：晚子時日柱算當天 選填，如果不傳遞這個參數，預設1 |
| 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步大運序號
"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": "日期有誤",
}