傳統八字-八字精盤
文件說明
八字精盤（亦稱八字流盤）是在基礎八字排盤的基礎上，進一步擴展的完整命盤資料介面。 相比普通八字排盤僅提供四柱、五行、十神等基礎資訊，八字精盤提供更加完整的資料，包括大運、流年、流月等詳細資訊。
八字精盤支援查詢完整流盤資訊，並可結合 【基礎工具-流日流時】 介面進一步取得精確到日、時的流日流時資料。 返回內容包含十神、藏干、納音、五行、自坐、星運、空亡、神煞、干支關係等多維度命理資訊。
為方便開發者快速理解介面返回結構，下圖展示了八字精盤包含的資料內容以及對應介面欄位說明。 滑鼠移動至圖片中的指定區域會顯示欄位提示，點擊後即可查看詳細參數資訊。
頻寬要求與載入模式相關：
1. 全量載入（load_mode=1）：
返回完整八字精盤資料，資料量約 900KB。
若伺服器頻寬較低，可能增加介面回應時間，建議使用 5M 以上頻寬。
2. 按需載入（load_mode=2）：
僅返回目前所需資料，資料量約 170KB。
不依賴較高頻寬支援，回應速度更快，推薦作為預設呼叫方式。
提示：
實際檔案傳輸速度通常約為頻寬標稱值的十分之一，
例如 5M 頻寬實際下載速度約為 0.5MB/s。
請求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Bazi/jingpan請求標頭 (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：晚子時日柱算當天 選填，如果不傳遞這個參數，預設2 |
| load_mode | Int | 載入模式 例：1：全量載入 2：按需載入(推薦) 選填，如果不傳遞這個參數，預設1 |
| dayun_index | Int | 載入指定輪大運全部資訊 例：2：第二輪大運 3：第三輪大運 4：第四輪大運 5：第五輪大運 6：第六輪大運 7：第七輪大運 8：第八輪大運 9：第九輪大運 選填，如果不傳遞這個參數，預設2 |
| iszip | Int | 是否開啟資料壓縮(傳統壓縮模式)。例：1：是 2：否
選填，如果不傳遞該參數，預設值為 2（返回純文字 JSON）。
|
| 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' => '0',
'type' => '1',
'year' => '1994',
'month' => '4',
'day' => '30',
'hours' => '10',
'minute' => '0',
'zhen' => '1',
'province' => '北京市',
'city' => '北京',
];回傳參數
| 欄位 | 型別 | 描述 |
|---|---|---|
| errcode | String | 狀態碼 0成功 其它為失敗 |
| errmsg | String | 狀態碼說明 |
| notice | String | 聲明 |
| data | Json | 資料內容 |
成功回傳範例
{
"errcode": 0,
"errmsg": "請求成功",
"notice":"本次測算結果僅供娛樂使用，請勿用於封建迷信和違法用途。",
"data": {
"base_info": {
"zhen": { //考慮真太陽時才會有此欄位，不考慮真太陽時就沒有這個欄位
"province": "北京市", //真太陽時省市
"city": "北京", //真太陽時省市
"jingdu": "116.46", //真太陽經度
"weidu": "39.92", //真太陽緯度
"shicha": "晚0小時14分10秒" //本地時間相對於真太陽時的時差
},
"sex": "乾造",
"name": "張三",
"gongli": "1994-04-30 10:00:00", //公曆(如果考慮真太陽時，此處為計算後的真太陽時公曆)
"nongli": "一九九四年三月二十日 巳時", //農曆(如果考慮真太陽時，此處為計算後的真太陽時農曆)
"qiyun": "1年10個月20天後起運", //起運
"jiaoyun": "1996-03-21後交運", //交運
"taiyuan": "己未", //胎元
"taiyuan_nayin": "天上火", //胎元納音
"taixi": "辛卯", //胎息
"taixi_nayin": "松柏木", //胎息納音
"minggong": "壬申", //命宮
"minggong_nayin": "劍鋒金", //命宮納音
"shengong": "甲戌", //身宮
"shengong_nayin": "山頭火", //身宮納音
"shengxiao": "狗", //生肖
"xingzuo": "金牛" //星座
"siling": "戊" //司令
"jiaoyun_mang": "逢丙、庚年 清明前3天的午時 交大運" //盲派口訣交運
"xingxiu": "胃宿西方白虎", //星宿
"minggua": {
"minggua_name": "乾", //命卦
"minggua_fangwei": "西四命" //命卦方位
}
"wuxing_wangdu": "水旺 木相 金休 土囚 火死", //五行旺度
"wuxing_xiji": "喜土 用火 閑金 仇水 忌木", //五行喜忌
"tiangan_liuyi": "戊癸合化火 戊壬相剋 壬乙相生", //天干留意
"dizhi_liuyi": "辰辰自刑 巳亥相衝", //地支留意
"zhengge": "傷官格", //八字正格
"xiyongshen": { //喜用神 無敵律數八字五行量化法
"qiangruo": "八字偏弱", //八字強弱
"xiyongshen": "金，水", //以金，水為喜用神
"jishen": "水", //以水為忌神
"xiyongshen_desc": "身弱，需補助，避免剋洩耗，喜用金補水，避木忌土火。", //喜用神說明
"jin_number": 0, //五行統計 金有0個
"mu_number": 1, //五行統計 木有1個
"shui_number": 2, //五行統計 水有2個
"huo_number": 3, //五行統計 火有3個
"tu_number": 2, //五行統計 土有2個
"tonglei": "金水", //同類為金水
"yilei": "木火土", //異類為木火土
"rizhu_tiangan": "水" //命主五行屬水
"zidang": 0, //自黨分
"yidang": 9, //異黨分
"zidang_percent": "0%", //自黨占百分比
"yidang_percent": "100%",//異黨占百分比
"jin_score": 75, //五行金能量分數
"mu_score": 16, //五行木能量分數
"shui_score": 118,//五行水能量分數
"huo_score": 36,//五行火能量分數
"tu_score": 139,//五行土能量分數
"jin_score_percent": "19.53%", //五行金能量占比
"mu_score_percent": "4.17%", //五行木能量占比
"shui_score_percent": "30.73%", //五行水能量占比
"huo_score_percent": "9.38%", //五行火能量占比
"tu_score_percent": "36.2%", //五行土能量占比
"yinyang": "陰陽平衡" //五行陰陽參考
},
"detail_info": {
"dayun_info": [ //排大運 農曆
{
"dayun_index": 1, //第1輪大運
"dayun_start_year": 1996, //大運起始年(包含)
"dayun_start_age": 3, //大運起始年齡(即歲數，包含)。
"dayun_end_year": 2005, //大運結束年(包含)。
"dayun_end_age": 12, //大運結束年齡(即歲數，包含)。
"dayun_start_ganzhi": "己巳", //大運起始年的干支。
"dayun_xun": "甲子", //該大運所在旬。
"dayun_kongwang": "戌亥", //空亡
"dayun_shishen": "傷官", //第1輪大運十神
"dayun_changsheng": "臨官", //第1輪大運長生
"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, //流年位於當前大運中的序號(數字，0-9)。
"liunian_year": 1996,
"liunian_age": 3,
"liunian_ganzhi": "丙子",
"liunian_xun": "甲戌",
"liunian_kongwang": "申酉",
"liunian_shishen": "比肩",
"liunian_changsheng": "胎",
"liunian_jieqi": [{ //流年12節氣
"jieqi_name": "立春", //流年節氣名
"jieqi_solar_ymdhms": "1994-02-04 09:30:56", //流年節氣陽曆資訊
"jieqi_lunar_ymdhms_isleap": "0", //流年節氣陰曆是否閏月，0否，1是
"jieqi_lunar_ymdhms": "1993-12-24 09:30:56" //流年節氣陰曆資訊
}, {
"jieqi_name": "驚蟄",
......
}, {
"jieqi_name": "清明",
......
}, {
"jieqi_name": "立夏",
......
}, {
"jieqi_name": "芒種",
......
}, {
"jieqi_name": "小暑",
......
}, {
"jieqi_name": "立秋",
......
},
......
{
"jieqi_name": "小寒",
"jieqi_solar_ymdhms": "1995-01-06 03:34:05",
"jieqi_lunar_ymdhms_isleap": "0",
"jieqi_lunar_ymdhms": "1994-12-06 03:34:05"
}],
"liunian_year_tg": "丙",
"liunian_year_dz": "子",
"liunian_year_cg": [
"癸"
],
"liunian_tg_god": "比肩",
"liunian_dz_god": [
"正官"
],
"liunian_dz_star_cs": "胎",
"liunian_dz_self_cs": "胎",
"liunian_nayin": "澗下水",
"liunian_wuxing": "火水",
"liunian_tg_liuyi": "庚癸相生 乙庚合化金 壬乙相生",
"liunian_dz_liuyi": "午亥暗合 巳亥相衝",
"liunian_shensha": "福星 天廚",
"liuyue_info": [ //流月資訊 農曆
{
"liuyue_index": 0,
"liuyue_month": "正",
"liuyue_ganzhi": "庚寅",
"liuyue_xun": "甲申",
"liuyue_kongwang": "午未",
"liuyue_shishen": "偏財",
"liuyue_changsheng": "長生",
"liuyue_month_tg": "庚",
"liuyue_month_dz": "寅",
"liuyue_month_cg": [
"甲",
"丙",
"戊"
],
"liuyue_month_tg_god": "偏財",
"liuyue_month_dz_god": [
"偏印",
"比肩",
"食神"
],
"liuyue_dz_star_cs": "長生",
"liuyue_dz_self_cs": "絕",
"liuyue_nayin": "松柏木",
"liuyue_wuxing": "金木"
"liuyue_tg_liuyi": "乙庚合化金 戊壬相剋 壬乙相生",
"liuyue_dz_liuyi": "寅午半合火局 寅巳相害"
"liuyue_shensha": "福星 天廚", //流月神煞
},
{...}, //第2個流月
{...}, //第3個流月
......
{...}, //第10個流月
{...}, //第11個流月
{...}, //第12個流月
},
{...}, //第二個流年
{...}, //第三個流年
{...},
{...},
{...},
{...},
{...},
{...},
{...},//第十個流年
],
"xiaoyun_info": [ //小運資訊 農曆
{
"xiaoyun_index": 0, //小運位於當前大運中的序號(數字，0-9)。
"xiaoyun_year": 1996,
"xiaoyun_age": 3,
"xiaoyun_ganzhi": "丙申",
"xiaoyun_xun": "甲午",
"xiaoyun_kongwang": "辰巳",
"xiaoyun_shishen": "比肩",
"xiaoyun_changsheng": "病"
"xiaoyun_year_tg": "戊",
"xiaoyun_year_dz": "申",
"xiaoyun_year_cg": [
"庚",
"壬",
"戊"
],
"xiaoyun_tg_god": "七殺",
"xiaoyun_dz_god": [
"偏印",
"比肩",
"七殺"
],
"xiaoyun_dz_star_cs": "長生",
"xiaoyun_dz_self_cs": "病",
"xiaoyun_nayin": "大驛土",
"xiaoyun_wuxing": "土金",
"xiaoyun_tg_liuyi": "戊癸合化火 戊壬相剋 壬乙相生",
"xiaoyun_dz_liuyi": "申亥相害 申辰半合水局 巳申合化水 巳亥相衝"
},
{...}, //第二個小運
{...},
{...},
{...},
{...},
{...},
{...},
{...},
{...},//第十個小運
],
"dayun_shensha": "祿神 亡神 干祿" //第1輪大運神煞
},
{
"dayun_index": 2, //第2輪大運
"dayun_start_year": 2006,
"dayun_start_age": 13,
"dayun_end_year": 2015,
"dayun_end_age": 22,
"dayun_start_ganzhi": "庚午",
"dayun_xun": "甲子",
"dayun_kongwang": "戌亥",
"dayun_shishen": "偏財",
"dayun_changsheng": "帝旺",
"liunian_info": [ //如果請求參數的 dayun_index 是非2值 則這裡沒有流年資訊
{...},
{...},
{...},
{...},
{...},
{...},
{...},
{...},
{...},
{...},
],
"xiaoyun_info": [ //如果請求參數的 dayun_index 是非2值 則這裡沒有小運資訊
{...},
{...},
{...},
{...},
{...},
{...},
{...},
{...},
{...},
{...},
],
"dayun_shensha": "天乙 羊刃 福星 將星" //第2輪大運神煞
},
{
...
"liunian_info": [
{...},
{...},
],
"xiaoyun_info": [
{...},
{...},
],
"dayun_shensha": "金輿 流霞" //第3輪大運神煞
},
{
...
"liunian_info": [
{...},
{...},
],
"xiaoyun_info": [
{...},
{...},
],
"dayun_shensha": "天德 文昌 驛馬" //第4輪大運神煞
},
{
......
},
{
...
"liunian_info": [
{...},
{...},
],
"xiaoyun_info": [
{...},
{...},
],
"dayun_shensha": "月德 國印" //第9輪大運神煞
}
],
"dayun_born_info":{// 出生年到第一個大運年期間每一年的資料(童限)
{...}, //欄位跟大運dayun_info內容一致，區別在於dayun_info是排大運，dayun_born_info是從出生年到第一個大運年之間幾年資料
}
"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": "祿神 文昌 天廚 亡神 紅鸞 干祿" //時柱神煞
}
}
"taishen_info": { //胎命身資訊
"taiyuan": { //胎元資訊
"ganzhi": "癸巳",
"xun": "甲申",
"kongwang": "午未",
"changsheng": "臨官",
"gan": "癸",
"zhi": "巳",
"dz_cg": [
"丙",
"庚",
"戊"
],
"tg_god": "正財",
"dz_god": [
"偏印",
"食神",
"比肩"
],
"dz_star_cs": "臨官",
"dz_self_cs": "胎",
"nayin": "長流水",
"wuxing": "水火",
"tg_liuyi": "丁癸相衝 丁壬合化木 壬乙相生",
"dz_liuyi": "巳亥相衝",
"shensha": "天乙 太極 祿神 流霞 劫煞 日貴"
},
"taixi": { //胎息資訊
"ganzhi": "癸巳",
"xun": "甲申",
"kongwang": "午未",
"changsheng": "臨官",
"gan": "癸",
"zhi": "巳",
"dz_cg": [
"丙",
"庚",
"戊"
],
"tg_god": "正財",
"dz_god": [
"偏印",
"食神",
"比肩"
],
"dz_star_cs": "臨官",
"dz_self_cs": "胎",
"nayin": "長流水",
"wuxing": "水火",
"tg_liuyi": "丁癸相衝 丁壬合化木 壬乙相生",
"dz_liuyi": "巳亥相衝",
"shensha": "天乙 太極 祿神 流霞 劫煞 日貴"
},
"minggong": { //命宮資訊
"ganzhi": "癸卯",
"xun": "甲午",
"kongwang": "辰巳",
"changsheng": "沐浴",
"gan": "癸",
"zhi": "卯",
"dz_cg": [
"乙"
],
"tg_god": "正財",
"dz_god": [
"正官"
],
"dz_star_cs": "沐浴",
"dz_self_cs": "長生",
"nayin": "金箔金",
"wuxing": "水木",
"tg_liuyi": "丁癸相衝 丁壬合化木 壬乙相生",
"dz_liuyi": "巳亥相衝",
"shensha": "天乙 福星 日貴"
},
"shengong": { //身宮資訊
"ganzhi": "癸卯",
"xun": "甲午",
"kongwang": "辰巳",
"changsheng": "沐浴",
"gan": "癸",
"zhi": "卯",
"dz_cg": [
"乙"
],
"tg_god": "正財",
"dz_god": [
"正官"
],
"dz_star_cs": "沐浴",
"dz_self_cs": "長生",
"nayin": "金箔金",
"wuxing": "水木",
"tg_liuyi": "丁癸相衝 丁壬合化木 壬乙相生",
"dz_liuyi": "巳亥相衝",
"shensha": "天乙 福星 日貴"
}
}
}
}
}
失敗回傳範例
{
"errcode": -1,
"errmsg": "日期有誤",
}