傳統八字-八字測算

文件說明

        八字，即生辰八字，是一個人出生時的干支曆日期。年干和年支組成年柱，月干和月支組成月柱，日干和日支組成日柱，時干和時支組成時柱，一共四柱，四個干和四個支共八個字，故又稱四柱八字。是命理研究方法之中最正統的一種。並在此基礎上，結合古籍測算出骨相，五行，姻緣，財運，基本資訊。如果需要十年大運以及流年測算結果，請參閱八字-八字精算API。

請求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Bazi/cesuan

請求標頭 (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，則經度與緯度皆為必填參數。
經度範圍：-180～180，浮點數，小數點後最多6位。
latitude float 十進位緯度 例：38.907192    
選填，但若 zhen=3，則經度與緯度皆為必填參數。
緯度範圍：-90～90，浮點數，小數點後最多6位。
timezone string 時區（IANA 格式），例：Asia/Shanghai
選填，預設 Asia/Shanghai
● zhen = 1（中國真太陽時）：時區固定為 Asia/Shanghai（程序會忽略傳入值）
● zhen = 2（不使用真太陽時）：本參數不影響計算
● zhen = 3（全球真太陽時）：建議傳出生地的 IANA 時區
例：紐約 America/New_York，新加坡 Asia/Singapore
使用當地時區可確保正確處理日光節約時間 (DST)。
點擊 此處 查看完整時區列表。
lang String 多語言：zh-cn 、en-us 、zh-tw     
選填，如果不傳遞這個參數，預設為 zh-cn
factor String 調整因子：例：0：不作調整 1：需要作調整     
選填，如果不傳遞這個參數，預設為 0
回傳資料中，姻緣(yinyuan)，財運(caiyun)，命運(mingyun)解析有一定的重複率，
可添加調整因子降低重複機率。

請求參數範例

$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": "傷官格"                  //八字正格
      "wuxing_xiji": "喜水 用金 閑木 仇火 忌土" //五行喜忌
    },
    "bazi_info": { //八字資訊
      "kw": "戌亥", //空亡
      "tg_cg_god": [ //天干十神
        "傷",        //天干十神【年】
        "殺",        //天干十神【月】
        "日元",      //天干十神【日】
        "劫"         //天干十神【時】
      ],
      "bazi": "戊辰 癸亥 丁卯 丙午", //八字干支資訊：分別對應 戊辰年 癸亥月 丁卯日 丙午時
      "na_yin": "大林木"           //納音
    },
    "chenggu": {   //稱骨資訊
      "year_weight": "1.2", //稱骨年重
      "month_weight": "1.8",//稱骨月重
      "day_weight": "1.6",  //稱骨日重
      "hour_weight": "1.0", //稱骨時重
      "total_weight": "5.6",//稱骨總重
      "description": "人品非凡，胸懷磊落，早年嘗過不少苦楚，但福祿無窮，財源滾滾，晚年豐足。" //稱骨斷辭
    },
    "wuxing": {    //五行資訊：五行從先天納音五行和八字能量五行角度分析，可按需選用，兩種分析角度不同，結果也會不同，甚至截然相反。
      "detail_desc": "戊辰年生大林木命", //先天五行納音
      "simple_desc": "木",            //先天五行屬性
      //八字能量五行分析(可以跟喜用神的五行能量對應)
      "simple_description": "從五行能量來看，主能量火氣盛，主熱忱之質天賦自帶。命主先天具感染力，行動力強，善惡分明，富正義感。火氣偏盛易生急躁，需防衝動誤事。次五行能量屬土，後天運勢主厚積薄發之態。命主後天在奔波中漸顯穩重，中年後根基愈固，行事更重長遠。需防安逸環境生惰性，宜持精進之心。後天利於在穩進中求成，事業多靠口碑積累，晚年根基深厚，可享基業之福。",
      //先天納音五行分析
      "detail_description": "先天納音大林木參天而立，天性正直向上。稟賦進取之心，有遠大志向，堅韌不拔，能在逆境中生長，自帶威嚴。待人坦誠，善惡分明，不喜阿諛。易顯孤傲，不善合群，略顯固執。天賦在於挺拔成長，然需防清高離群。後天經責任淬煉，學會了適度留白與自我關照。熱忱包容的本性不變，卻懂得設立邊界，奉獻中添了自我保護，積極主動更兼分寸感。責任感化為穩健支撐，能帶動他人亦懂借力分擔，昔日操心過甚變為統籌有度。火焰溫暖而不耗竭，既能持續釋放光熱照亮周遭，也懂得留存能量，在付出與自我滋養間找到平衡，熱忱而不疲憊。"
    },
    "yinyuan": {  //姻緣資訊
      "sanshishu_yinyuan": "另一半必須年長十五年或以上，夫婦有共同的興趣，互相尊重，晚年二人死亡的差距不足五年。" //姻緣解析斷語
    },
    "caiyun": {   //財運資訊
      "sanshishu_caiyun": {
        "simple_desc": "先苦後甜", //三世書財運簡批
        "detail_desc": "暗祿，受前世影響，今生與家人難和睦相處，別奢望可以靠屋企發達。財運先苦後甜，需依賴朋友致富，不妨找個有信用的拍檔做生意。晚景甚佳，積落不少金錢，長壽而健康。" //三世書財運詳批
      }
    },
    "sizhu": {   //四柱資訊
      "rizhu": "丁卯日柱之婚姻，為直覺靈敏，喜用成例，而耐容忍，具有學者之氣質，而酷酷嗜陳舊古跡，是守舊復古之象態。其氣也，震動百里，驚遠懼邇之象，陰火焰強，而力韌，純焚幔蝕，能鍛強鋼。丁卯日柱之佳配為壬戌，遇合之機在子水歲運，肖鼠之年，以屬犬者性合。此型態之婚姻，屬水朏交溶之態，混為一體，禮仁下士，緊隨不舍，蓮荷出汙泥而不染，氣質清雅，一語驚天之態，琴韻之聲也。" //日柱論命
    },
    "mingyun": {   //命運解析斷語
      "sanshishu_mingyun": "時遇天文秀氣清，聰明智慧心性靈，男財女秀身清潔，滿腹文章錦繡成。"
    },
    "sx": "龍",     //生肖資訊
    "xz": "天蠍座",   //星座資訊
    "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": "陰陽平衡" //五行陰陽參考
       }
   }
}

失敗回傳範例

{
  "errcode": -1,
  "errmsg": "日期有誤",
}
導覽目錄