傳統八字-流年財運分析

文件說明

        根據《子平真詮》、《淵海子平》、《三命通會・論財》基於使用者提供的出生時間（年/月/日/時）、性別及目標流年，結合八字命理中的「五行生剋」「干支關係」「身強身弱」「財星顯隱」等核心邏輯，計算並返回該流年的財運綜合分析報告，包含財運等級、財星型別、漏財風險、每月財運建議及風水提升方向等資訊，為使用者提供命理層面的流年財運參考。

請求方式

POST GET 

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

請求標頭 (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
liu_year Int 需要分析哪個流年的財運 例: 2030 
此參數只能大於等於當前公曆年份
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 、zh-tw、en-us     
選填，如果不傳遞這個參數，預設為 zh-cn

請求參數範例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'name' => '張三',
'sex' => '1',
'type' => '1',
'year' => '1988',
'liu_year' => '2025',
'month' => '1',
'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小時18分57秒" //考慮真太陽的時差
      },
      "sex": "坤造",//性別
      "name": "張三",//命主姓名
      "gongli": "1988年1月8日12時1分",    //公曆(如果考慮真太陽時，此處為計算後的真太陽時公曆)
      "nongli": "丁卯年 十一月 十九日 午時", //農曆(如果考慮真太陽時，此處為計算後的真太陽時農曆)
      "qiyun": "9年1月23天起運",         //起運
      "jiaoyun": "1997年1月14日1時12分38秒", //交運
      "dayun": "丙辰",   //流年所在的大運干支
      "liunian": "乙巳", //指定的流年干支
      "qiangruo": "八字偏弱", //八字身強身弱
      "zhengge": "正官格" //八字正格
    },
    "bazi_info": { //八字資訊
      "kw": "子丑",  //空亡
      "tg_cg_god": [ //天干十神
        "正財",  //年干十神
        "劫財",  //月干十神
        "日元",  //日干十神
        "偏財"   //時干十神
      ],
      "bazi": [ //四柱八字資訊
        "丁卯",  //年干支
        "癸丑",  //月干支
        "壬戌",  //日干支
        "丙午"   //時干支
      ],
      "dz_cg": [ //地支藏干
        "乙",  //年支藏干
        "己|癸|辛",//月支藏干
        "戊|辛|丁",//日支藏干
        "丁|己"    //時支藏干
      ],
      "dz_cg_god": [ //地支藏干十神
        "傷官",    //地支藏干十神【年】
        "正官|劫財|正印",  //地支藏干十神【月】
        "七殺|正印|正財",  //地支藏干十神【日】
        "正財|正官"  //地支藏干十神【時】
      ],
      "day_cs": [ //八字長生衰旺
        "死",     //八字長生衰旺【年】
        "衰",     //八字長生衰旺【月】
        "冠帶",   //八字長生衰旺【日】
        "胎"      //八字長生衰旺【時】
      ],
      "na_yin": [  //五行納音
        "爐中火",  //五行納音【年】
        "桑柘木",  //五行納音【月】
        "大海水",  //五行納音【日】
        "天河水"   //五行納音【時】
      ]
    },
    "caiyun_info": { //財運分析結果
      //流年整體財運分數
      "yearlyOverallFortuneScore": 86,
      //流年財星顯隱
      "yearlyFortuneStarVisibility": "此年財星隱於地支，表面機會不顯，但....",
      //流年財星類別[正財或者偏財]
      "yearlyFortuneStarCategory": "正財氣足，固定收入進賬穩定，職場能力....",
      //身強與身弱分析
      "bodyStrengthVsWeakness": "日主身弱，但流年吉星護持，顯示雖自身能力有限，但....",
      //流年與命支分析
      "yearlyVsDestinyBranch": "流年與命支呈現合多於衝，財星安穩。今年是....",
      //流年財庫分析
      "yearlyFortuneTreasuryInfo": "無財庫的命局，今年財星卻旺，格局為「財星有根，流動生財」....",
      //大運與流年分析
      "majorFortunePeriodVsYearly": "大運為財星長生之地，流年為財星沐浴之地，運歲地支相....",
      //流年每月財運 + 投資提示
      "yearlyMonthlyFortuneAndInvestmentTips": [
        //1月財運投資提示
        "本月正財氣足，固定薪資較上期增長，職場穩定性高，穩健理財可放大收益。....",
        //2月財運投資提示
        "流月正財旺盛，主業收入無斷層，職場能力持續變現，適合中長期穩健規....",
        //3月財運投資提示
        "本月正財得勢，固定收益來源紮實，職場晉升近在眼前，依托主業理財更可靠。....",
        //4月財運投資提示
        "流月正財興旺，主業薪資、福利雙優，日常開支無壓力，可佈局低風險投資....",
        //5月財運投資提示
        "本月正財旺相，固定收入穩步上漲，職場發展助力財氣，堅守主業是聚財關鍵....",
         //6月財運投資提示
        "流月正財得力，主業提成、獎金進賬穩定，適合專注業務，同步做穩健理財。....",
         //7月財運投資提示
        "本月正財氣足，固定薪資有明確漲幅，職場環境佳，低風險理財易見成效。流....",
         //8月財運投資提示
        "流月正財旺盛，主業收入持續向好，職場能力獲器重，財富積累以穩為核心。....",
         //9月財運投資提示
        "本月正財得勢，固定收益（薪資、獎金）可觀，職場晉升機會清晰，適配穩健理....",
         //10月財運投資提示
        "流月正財興旺，主業收益無波動，職場福利到位，適合依托主業做財富規劃。....",
        "本月正財旺相，固定薪資較上月提升，職場發展順風順水，低風險投資易獲利。....",
         //12月財運投資提示
        "流月正財得力，主業收入穩定增長，職場機遇多，堅守現有崗位易聚財。流月....",
      ],
      //先天財運格局
      "innateFortunePattern": "日主五行屬水，而水剋火，故財星屬火，財運好....",
      //漏財風險提示
      "fortuneLeakageRiskTips": "財星得扶，漏財僅在「社交禮儀開支」（如紅包、....",
      //提升財運建議
      "fortuneImprovementSuggestions": "財星屬火，主光明與熱情之財，宜南....",
      //大師財運建議
      "masterFortuneSuggestions": "身弱逢此年財星臨貴人，財運與貴人運交織....",
    }
  }
}

失敗回傳範例

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