傳統八字-八字合婚
文件說明
緣份居八字合婚依據雙方的生辰八字，以本命卦，年支同氣，月令合，日干合，天干五合，合婚論吉凶，並給出相應分數，測算結果僅供參考。
請求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Bazi/hehun請求標頭 (Headers)
| 欄位 | 型別 | 描述 |
|---|---|---|
| Content-Type | String | application/x-www-form-urlencoded |
請求參數
| 欄位 | 型別 | 描述 |
|---|---|---|
| api_key | String | 存取金鑰 (API Key) |
| male_name | String | 男方姓名 |
| male_type | Int |
男方曆法類型 0：農曆 1：公曆
建議：對於農曆，若出生年包含閏月或需極高精度時，強烈推薦先呼叫【基礎工具-陰陽曆互相轉換】獲取公曆，再以 type=1 傳入。
|
| male_year | Int | 男方出生年 例：1986 |
| male_month | Int | 男方出生月 例: 8
注意：本API不處理閏月。若該年存在閏月，請通過轉換工具獲取公曆後再行帶入。
|
| male_day | Int | 男方出生日 例：16 |
| male_hours | Int | 男方出生時 例：8 |
| male_minute | Int | 男方出生分 例：34 如果不知道具體分，可以傳數字 0 |
| female_name | String | 女方姓名 |
| female_type | Int |
女方曆法類型 0：農曆 1：公曆
建議：對於農曆，若出生年包含閏月或需極高精度時，強烈推薦先呼叫【基礎工具-陰陽曆互相轉換】獲取公曆，再以 type=1 傳入。
|
| female_year | Int | 女方出生年 例：1986 |
| female_month | Int | 女方出生月 例: 8
注意：本API不處理閏月。若該年存在閏月，請通過轉換工具獲取公曆後再行帶入。
|
| female_day | Int | 女方出生日 例：16 |
| female_hours | Int | 女方出生時 例：8 |
| female_minute | Int | 女方出生分 例：34 如果不知道具體分，可以傳數字 0 |
| lang | String | 多語言：zh-cn 、zh-tw 、en-us 選填，如果不傳遞這個參數，預設為 zh-cn |
| mode | Int |
評分模式 / 評分嚴格度： • 1：傳統嚴苛模式，還原古法二元判定（非滿分即零分） • 2：彈性梯度模式，兼顧半合生剋緩衝，體驗更佳（推薦） 非必傳，預設為 1
|
請求參數範例
$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'male_name' => '張三',
'male_type' => '1',
'male_year' => '1988',
'male_month' => '11',
'male_day' => '8',
'male_hours' => '12',
'male_minute' => '20',
'female_name' => '李四',
'female_type' => '1',
'female_year' => '1988',
'female_month' => '11',
'female_day' => '8',
'female_hours' => '12',
'female_minute' => '20',
];回傳參數
| 欄位 | 型別 | 描述 |
|---|---|---|
| errcode | String | 狀態碼 0成功 其它為失敗 |
| errmsg | String | 狀態碼說明 |
| notice | String | 聲明 |
| data | Json | 資料內容 |
成功回傳範例
{
"errcode": 0,
"errmsg": "請求成功",
"notice":"本次測算結果僅供娛樂使用，請勿用於封建迷信和違法用途。",
"data": {
"male": {
"bazi": [ //男方八字
"戊辰", //男方八字【年】
"癸亥", //男方八字【月】
"丁卯", //男方八字【日】
"丙午" //男方八字【時】
],
"gl_year": "1988", //男方公曆年
"gl_month": "11", //男方公曆月
"gl_day": "8", //男方公曆日
"gl_hours": "12", //男方公曆時
"nl_year": "1987", //男方農曆年
"nl_month": "10", //男方農曆月
"nl_day": "3", //男方農曆日
"nl_hours": "12", //男方農曆時
"sex": "乾造", //性別
"name": "張三", //男方姓名
"gongli": "1988年11月8日12時20分", //男方公曆年月日時分
"nongli": "一九八八年臘月十二日 辰時", //男方農曆年月日時分
"kw": "戌亥", //男方空亡
"tg_cg_god": [ //男方天干十神
"傷", //男方天干十神【年】
"殺", //男方天干十神【月】
"日元", //男方天干十神【日】
"劫" //男方天干十神【時】
],
"dz_cg": [ //男方地支藏干
"戊|乙|癸", //男方地支藏干【年】
"壬|甲", //男方地支藏干【月】
"乙", //男方地支藏干【月】
"丁|己" //男方地支藏干【時】
],
"dz_cg_god": [ //男方地支藏干十神
"傷|梟|殺", //男方地支藏干十神【年】
"官|印", //男方地支藏干十神【月】
"梟", //男方地支藏干十神【月】
"比|食" //男方地支藏干十神【時】
],
"day_cs": [ //男方八字長生衰旺
"衰", //男方八字長生衰旺【年】
"胎", //男方八字長生衰旺【月】
"病", //男方八字長生衰旺【日】
"臨官" //男方八字長生衰旺【時】
],
"na_yin": [ //男方八字納音
"大林木", //男方八字納音【年】
"大海水", //男方八字納音【月】
"爐中火", //男方八字納音【日】
"天河水" //男方八字納音【時】
]
},
"female": {
"bazi": [ //女方八字
"戊辰", //女方八字【年】
"癸亥", //女方八字【月】
"丁卯", //女方八字【日】
"丙午" //女方八字【時】
],
"gl_year": "1988", //女方公曆年
"gl_month": "11", //女方公曆月
"gl_day": "8", //女方公曆日
"gl_hours": "12", //女方公曆時
"nl_year": "1987", //女方農曆年
"nl_month": "10", //女方農曆月
"nl_day": "3", //女方農曆日
"nl_hours": "12", //女方農曆時
"sex": "坤造", //性別
"name": "李四", //女方姓名
"gongli": "1988年11月8日12時20分", //女方公曆年月日時分
"nongli": "二〇二五年臘月初八日 辰時", //女方農曆年月日時分
"kw": "戌亥", //女方空亡
"tg_cg_god": [ //女方天干十神
"傷", //女方天干十神【年】
"殺", //女方天干十神【月】
"日元", //女方天干十神【日】
"劫" //女方天干十神【時】
],
"dz_cg": [ //女方地支藏干
"戊|乙|癸", //女方地支藏干【年】
"壬|甲", //女方地支藏干【月】
"乙", //女方地支藏干【日】
"丁|己" //女方地支藏干【時】
],
"dz_cg_god": [ //女方地支藏干十神
"傷|梟|殺", //女方地支藏干十神【年】
"官|印", //女方地支藏干十神【月】
"梟", //女方地支藏干十神【日】
"比|食" //女方地支藏干十神【時】
],
"day_cs": [ //女方八字長生衰旺
"衰", //女方八字長生衰旺【年】
"胎", //女方八字長生衰旺【月】
"病", //女方八字長生衰旺【日】
"臨官" //女方八字長生衰旺【時】
],
"na_yin": [ //女方八字納音
"大林木", //女方八字納音【年】
"大海水", //女方八字納音【月】
"爐中火", //女方八字納音【日】
"天河水" //女方八字納音【時】
]
},
"minggong": { //合婚命宮
"male_fengshui": "東四命",
"female_fengshui": "東四命",
"score": "30", //合婚命宮評分
"male_minggong": "震",
"female_minggong": "震",
"description": "此項為30分。說明：以東四命與西四命之說來合，如果相合，那麼在購屋時，應買與自己命宮相合的房子。"
"detail_description": "男方命卦為震，適宜住宅方位為東方。女方命卦為震，適宜住宅方位為東方。兩...." //命宮詳細解析斷語
},
"nianqitongzhi": { //年支同氣
"score": "20", //年支同氣評分
"male_nian_zhi": "辰",
"male_nian_zhi_desc": "木",
"female_nian_zhi": "辰",
"female_nian_zhi_desc": "木",
"description": "此項為20分。說明：如寅卯辰會東方木氣，虎兔龍結合的機緣就大於其它屬相；巳午未會南方火氣，蛇馬羊結合的機緣就大於其它屬相；申酉戌會西方金氣，猴雞狗結合的機緣就大於其它屬相；亥子丑會北方水氣，豬鼠牛結合的機緣就大於其它屬相。"
"detail_description": "男方年支為辰，女方年支為辰。此局為辰辰自刑。年支代表父母宮，此局自刑...."//年氣同支詳細解析斷語
},
"yueling": { //月令合
"score": "5", //月令合評分
"male_yue_zhi": "亥",
"female_yue_zhi": "亥",
"description": "此項為5分。說明：男女生月相同者互相間也是很有緣份的。"
"detail_description": "男方月支為辰，女方月支為辰。此局為亥亥自刑。月支代表兄弟...."//月令合詳細解析斷語
},
"rigan": { //日干相合
"score": "25",//日干相合評分
"male_yue_zhi": "丁",
"female_yue_zhi": "丁",
"male_ri_gan": "乙",
"female_ri_gan": "甲",
"description": "此項為25分。說明：何謂日干陰陽舒配得所？日干五行相同，一陰一陽的組合男女結合的機緣最大，如甲日干逢乙日干，庚日干逢辛日干之類。"
"detail_description": "男方日干為丁。五行資訊：五行屬火，謂之純陰之火；女...."//日干相合詳細解析斷語
},
"tiangan": { //天干五合
"score": "5", //天干五合評分
"male_yue_zhi": "丁",
"female_yue_zhi": "丁",
"male_ri_gan": "乙",
"female_ri_gan": "甲",
"description": "此項為5分。說明：其次是天干五合，如甲日干逢己日干，庚日干逢乙日干之類。再次則是比和或相生。"
"detail_description": "男方日天干為丁，女方日天干為丁。此局為。日干代表夫妻宮，此......"//天干五合詳細解析斷語
},
"zinv": { //子女同步
"nannv": "男", //生男生女
"score": "15", //子女同步評分
"description": "此項為15分。說明：何謂子女同步？西方的科學家在探索男女結合的奧秘時提出了【性染色體論】，我們東方人在四柱中看頭胎子女的性別，男女雙方的八字中頭胎子女的性別必須一致。"
"detail_description": "頭胎可能生男，此為報恩男，他將繼承家族血脈......"//子女同步詳細解析斷語
},
"all_score": 100, //合婚總分
"male_sx": "龍", //男方生肖
"female_sx": "龍", //女方生肖
"male_xz": "天蠍座", //男方星座
"female_xz": "天蠍座"//女方星座
"master_evaluation": { //大師級綜合總評
"mode_applied": "flexible", //當前采用的評分模式 (flexible/strict)
"stars": 5, //匹配星級指數 (取值 2 - 5 星)
"grade_title": "天作之合·上吉良緣", //評級稱號
"master_verdict": "此局命宮同氣、幹支多合，彼此磁場天然呼應...", //大師斷語
"guidance_advice": "珍惜彼此初心，順應天地造化之緣..." //相處/化解建議
},
}
}
}
失敗回傳範例
{
"errcode": -1,
"errmsg": "日期有誤",
}