傳統八字-八字排盤
文件說明
將年月日時排成命盤，每個時間概念稱為一柱，共有四柱，每柱有天干地支兩個字，共八個字，故稱四柱八字排盤。
注意：本API僅返回四柱基礎原盤及基本大運框架。如果您的業務需要更深度的五行量化分數、喜用神/忌神斷語分析，或者需要高精度的流年、流月、小運、童限（出生後至起運前）詳細時序運勢流資料，請呼叫功能更全面的 【傳統八字-八字精盤】 API。
請求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Bazi/paipan請求標頭 (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' => '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": "1988年11月8日12時20分", //公曆(如果考慮真太陽時，此處為計算後的真太陽時公曆年)
"nongli": "戊辰年 九月 廿九日 午時", //農曆(如果考慮真太陽時，此處為計算後的真太陽時農曆年)
"qiyun": "9年6月26天起運", //起運
"jiaoyun": "1998年4月16日16時52分1秒" //交運
"zhengge": "傷官格" //八字正格
},
"bazi_info": { //八字資訊
"kw": "戌亥", //空亡
"tg_cg_god": [ //天干十神
"傷官",
"七殺",
"日元",
"劫財"
],
"bazi": [ //八字四柱
"戊辰", //八字四柱【年】
"癸亥", //八字四柱【月】
"丁卯", //八字四柱【日】
"丙午" //八字四柱【時】
],
"dz_cg": [ //地支藏干
"戊|乙|癸", //地支藏干【年】
"壬|甲", //地支藏干【月】
"乙", //地支藏干【日】
"丁|己" //地支藏干【時】
],
"dz_cg_god": [ //地支藏干十神
"傷官|偏印|七殺", //地支藏干十神【年】
"正官|正印", //地支藏干十神【月】
"偏印", //地支藏干十神【日】
"比劫|食神" //地支藏干十神【時】
],
"day_cs": [ //八字長生衰旺
"衰", //八字長生衰旺【年】
"胎", //八字長生衰旺【月】
"病", //八字長生衰旺【日】
"臨官" //八字長生衰旺【時】
],
"na_yin": [ //五行納音
"大林木", //五行納音【年】
"大海水", //五行納音【月】
"爐中火", //五行納音【日】
"天河水" //五行納音【時】
]
},
"dayun_info": { //排大運資訊
"big_god": [ //大運神
"正印",
"偏印",
"劫財",
"比肩",
"傷官",
"食神",
"偏財",
"正財",
"正官",
"七殺",
"正印",
"偏印"
],
"big": [ //大運神對應天干地支
"甲子",
"乙丑",
"丙寅",
"丁卯",
"戊辰",
"己巳",
"庚午",
"辛未",
"壬申",
"癸酉",
"甲戌",
"乙亥"
],
"big_cs": [ //大運神對應長生衰旺
"絕",
"墓",
"死",
"病",
"衰",
"帝旺",
"臨官",
"冠帶",
"沐浴",
"長生",
"養",
"胎"
],
"xu_sui": [ //大運神對應虛歲
11,
21,
31,
41,
51,
61,
71,
81,
91,
101,
111,
121
],
"big_start_year": [ //大運始於年份
1998,
2008,
2018,
2028,
2038,
2048,
2058,
2068,
2078,
2088,
2098,
2108
],
"big_start_year_liu_nian": "", //大運流年
"big_end_year": [ //大運止於年份
2007,
2017,
2027,
2037,
2047,
2057,
2067,
2077,
2087,
2097,
2107,
2117
],
"years_info0": [ //從大運第1個始於年到大運第1個止於年裡所有年柱
{
"year_char": "戊寅"
},
{
"year_char": "戊子"
},
{
"year_char": "戊戌"
},
{
"year_char": "戊申"
},
{
"year_char": "戊午"
},
{
"year_char": "戊辰"
},
{
"year_char": "戊寅"
},
{
"year_char": "戊子"
},
{
"year_char": "戊戌"
},
{
"year_char": "戊申"
},
{
"year_char": "戊午"
},
{
"year_char": "戊辰"
}
],
"years_info1": [ //從大運第2個始於年到大運第2個止於年裡所有年柱
{
"year_char": "己卯"
},
{
"year_char": "己丑"
},
{
"year_char": "己亥"
},
{
"year_char": "己酉"
},
{
"year_char": "己未"
},
{
"year_char": "己巳"
},
{
"year_char": "己卯"
},
{
"year_char": "己丑"
},
{
"year_char": "己亥"
},
{
"year_char": "己酉"
},
{
"year_char": "己未"
},
{
"year_char": "己巳"
}
],
"years_info2": [ //從大運第3個始於年到大運第3個止於年裡所有年柱
{
"year_char": "庚辰"
},
{
"year_char": "庚寅"
},
{
"year_char": "庚子"
},
{
"year_char": "庚戌"
},
{
"year_char": "庚申"
},
{
"year_char": "庚午"
},
{
"year_char": "庚辰"
},
{
"year_char": "庚寅"
},
{
"year_char": "庚子"
},
{
"year_char": "庚戌"
},
{
"year_char": "庚申"
},
{
"year_char": "庚午"
}
],
"years_info3": [ //從大運第4個始於年到大運第4個止於年裡所有年柱
{
"year_char": "辛巳"
},
{
"year_char": "辛卯"
},
{
"year_char": "辛丑"
},
{
"year_char": "辛亥"
},
{
"year_char": "辛酉"
},
{
"year_char": "辛未"
},
{
"year_char": "辛巳"
},
{
"year_char": "辛卯"
},
{
"year_char": "辛丑"
},
{
"year_char": "辛亥"
},
{
"year_char": "辛酉"
},
{
"year_char": "辛未"
}
],
"years_info4": [ //從大運第5個始於年到大運第5個止於年裡所有年柱
{
"year_char": "壬午"
},
{
"year_char": "壬辰"
},
{
"year_char": "壬寅"
},
{
"year_char": "壬子"
},
{
"year_char": "壬戌"
},
{
"year_char": "壬申"
},
{
"year_char": "壬午"
},
{
"year_char": "壬辰"
},
{
"year_char": "壬寅"
},
{
"year_char": "壬子"
},
{
"year_char": "壬戌"
},
{
"year_char": "壬申"
}
],
"years_info5": [ //從大運第6個始於年到大運第6個止於年裡所有年柱
{
"year_char": "癸未"
},
{
"year_char": "癸巳"
},
{
"year_char": "癸卯"
},
{
"year_char": "癸丑"
},
{
"year_char": "癸亥"
},
{
"year_char": "癸酉"
},
{
"year_char": "癸未"
},
{
"year_char": "癸巳"
},
{
"year_char": "癸卯"
},
{
"year_char": "癸丑"
},
{
"year_char": "癸亥"
},
{
"year_char": "癸酉"
}
],
"years_info6": [ //從大運第7個始於年到大運第7個止於年裡所有年柱
{
"year_char": "甲申"
},
{
"year_char": "甲午"
},
{
"year_char": "甲辰"
},
{
"year_char": "甲寅"
},
{
"year_char": "甲子"
},
{
"year_char": "甲戌"
},
{
"year_char": "甲申"
},
{
"year_char": "甲午"
},
{
"year_char": "甲辰"
},
{
"year_char": "甲寅"
},
{
"year_char": "甲子"
},
{
"year_char": "甲戌"
}
],
"years_info7": [ //從大運第8個始於年到大運第8個止於年裡所有年柱
{
"year_char": "乙酉"
},
{
"year_char": "乙未"
},
{
"year_char": "乙巳"
},
{
"year_char": "乙卯"
},
{
"year_char": "乙丑"
},
{
"year_char": "乙亥"
},
{
"year_char": "乙酉"
},
{
"year_char": "乙未"
},
{
"year_char": "乙巳"
},
{
"year_char": "乙卯"
},
{
"year_char": "乙丑"
},
{
"year_char": "乙亥"
}
],
"years_info8": [ //從大運第9個始於年到大運第9個止於年裡所有年柱
{
"year_char": "丙戌"
},
{
"year_char": "丙申"
},
{
"year_char": "丙午"
},
{
"year_char": "丙辰"
},
{
"year_char": "丙寅"
},
{
"year_char": "丙子"
},
{
"year_char": "丙戌"
},
{
"year_char": "丙申"
},
{
"year_char": "丙午"
},
{
"year_char": "丙辰"
},
{
"year_char": "丙寅"
},
{
"year_char": "丙子"
}
],
"years_info9": [ //從大運第10個始於年到大運第10個止於年裡所有年柱
{
"year_char": "丁亥"
},
{
"year_char": "丁酉"
},
{
"year_char": "丁未"
},
{
"year_char": "丁巳"
},
{
"year_char": "丁卯"
},
{
"year_char": "丁丑"
},
{
"year_char": "丁亥"
},
{
"year_char": "丁酉"
},
{
"year_char": "丁未"
},
{
"year_char": "丁巳"
},
{
"year_char": "丁卯"
},
{
"year_char": "丁丑"
}
]
},
"start_info": {
"jishen": [ //吉神兇煞
"太極", //吉神兇煞【年】
"空亡 福星 學堂 亡神 元辰(大耗) 紅鸞", //吉神兇煞【月】
"太極 六厄", //吉神兇煞【日】
"祿神 天廚 災煞 干祿" //吉神兇煞【時】
],
"xz": "天蠍座", //星座
"sx": "龍" //生肖
},
"detail_info": { //八字詳細資訊
"zhuxing": { //四柱主星
"year": "傷官", //年柱主星
"month": "比肩", //月柱主星
"day": "日元", //日柱主星
"hour": "食神" //時柱主星
},
"sizhu": { //四柱天干地支
"year": {
"tg": "己", //年柱天干
"dz": "巳" //年柱地支
},
"month": {
"tg": "丙", //月柱天干
"dz": "子" //月柱地支
},
"day": {
"tg": "丙", //日柱天干
"dz": "寅" //日柱地支
},
"hour": {
"tg": "戊", //時柱天干
"dz": "子" //時柱地支
}
},
"canggan": { //四柱藏干資訊
"year": [ //年柱藏干
"丙",
"戊",
"庚"
],
"month": [ //月柱藏干
"癸"
],
"day": [ //日柱藏干
"甲",
"丙",
"戊"
],
"hour": [ //時柱藏干
"癸"
]
},
"fuxing": { //四柱副星資訊
"year": [ //年柱副星
"比肩",
"食神",
"正財"
],
"month": [ //月柱副星
"正官"
],
"day": [ //日柱副星
"偏印",
"比肩",
"食神"
],
"hour": [ //時柱副星
"正官"
]
},
"xingyun": { //四柱星運資訊
"year": "臨官", //年柱星運
"month": "胎", //月柱星運
"day": "長生", //日柱星運
"hour": "胎" //時柱星運
},
"zizuo": { //四柱自坐資訊
"year": "帝旺", //年柱自坐
"month": "胎", //月柱自坐
"day": "長生", //日柱自坐
"hour": "胎" //時柱自坐
},
"kongwang": { //四柱空亡資訊
"year": "戌亥", //年柱空亡
"month": "申酉", //月柱空亡
"day": "戌亥", //日柱空亡
"hour": "午未" //時柱空亡
},
"nayin": { //四柱納音資訊
"year": "大林木", //年柱納音
"month": "澗下水", //月柱納音
"day": "爐中火", //日柱納音
"hour": "霹靂火" //時柱納音
},
"shensha": { //四柱神煞資訊
"year": "天德 祿神 亡神 干祿", //年柱神煞
"month": "天乙 福星 天廚 六厄", //月柱神煞
"day": "福星 國印 紅艷 劫煞 詞館", //日柱神煞
"hour": "天乙 福星 天廚 六厄" //時柱神煞
},
"dayunshensha": [ //大運神煞
{
"tgdz": "戊辰", //第1個大運天干地支
"shensha": "太極 " //第1個大運神煞
},
{
"tgdz": "丁卯", //第2個大運天干地支
"shensha": "太極 月德 桃花 " //第2個大運神煞
},
{
"tgdz": "丙寅",
"shensha": "福星 紅艷 "
},
{
"tgdz": "乙丑",
"shensha": "福星 國印 "
},
{
"tgdz": "甲子",
"shensha": "太極 福星 天廚 "
},
{
"tgdz": "癸亥",
"shensha": "空亡 天醫 天廚 劫煞 "
},
{
"tgdz": "壬戌",
"shensha": "空亡 華蓋 "
},
{
"tgdz": "辛酉",
"shensha": "太極 "
},
{
"tgdz": "庚申",
"shensha": "文昌 驛馬 "
},
{
"tgdz": "己未",
"shensha": "太極 金輿 福星 流霞 "
},
{
"tgdz": "戊午",
"shensha": "羊刃 天廚 將星 "
},
{
"tgdz": "丁巳", //第12個大運天干地支
"shensha": "天德 月德 祿神 天廚 亡神 干祿 " //第12大運神煞
}
]
}
}
}
}
失敗回傳範例
{
"errcode": -1,
"errmsg": "日期有誤",
}