傳統八字-未來運勢
文件說明
本API基於傳統命理文化模型，對個人資訊進行結構化分析，結合流年、流月等時間維度因素，對指定年份及其下屬月份、日期進行趨勢性分析展示。內容涵蓋財務、事業、情感、學業及健康等多個維度的參考資訊，用於輔助理解不同時間階段的變化特徵。
本系統在設計過程中參考了《滴天髓》、《神峰通考》等傳統典籍，通過資料建模與規則整理，對相關資訊進行歸納與表達，結果僅作為資訊參考與文化研究用途，不構成任何現實決策依據。
注意：如開啟欄位 compute_daily（每日分析），回傳資料量約600KB以上，對網路頻寬有一定要求，建議在4M以上頻寬環境下使用；如關閉該欄位，資料量約100KB左右，普通頻寬即可正常使用。
請求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Bazi/weilai請求標頭 (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 |
| yunshi_year | Int | 需要測未來哪個公曆年 例: 2030 此參數只能大於等於當前公曆年份 |
| compute_daily | Int | 是否算每日運勢 例： 1：是 2：否 選填，不傳遞這個參數，預設2 |
| sect | Int | 流派 例：1：晚子時日柱算明天 2：晚子時日柱算當天 選填，如果不傳遞這個參數，預設2 |
| 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 、en-us 、zh-tw 選填，如果不傳遞這個參數，預設為 zh-cn |
請求參數範例
$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'name' => '張三',
'sex' => '1',
'year' => '1988',
'month' => '11',
'day' => '8',
'hours' => '12',
'minute' => '20',
'yunshi_year' => '2024',
'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-08 10:00:00", //公曆(如果考慮真太陽時，此處為計算後的真太陽時公曆)
"nongli": "一九八八年九月廿九日 巳時", //農曆(如果考慮真太陽時，此處為計算後的真太陽時農曆)
"qiyun": "9年7個月10天後起運", //起運
"jiaoyun": "1998-06-18後交運", //交運
"taiyuan": "甲寅", //胎元
"taiyuan_nayin": "大溪水", //胎元納音
"taixi": "壬戌", //胎息
"taixi_nayin": "大海水", //胎息納音
"minggong": "乙丑", //命宮
"minggong_nayin": "海中金", //命宮納音
"shengong": "丁巳", //身宮
"shengong_nayin": "沙中土", //身宮納音
"shengxiao": "龍", //生肖
"xingzuo": "天蠍", //星座
"siling": "壬", //司令
"jiaoyun_mang": "大寒當日寅時 交大運", //交運 盲派演算法
"xingxiu": "尾宿東方青龍", //星宿
"minggua": { //命卦
"minggua_name": "震", //命卦
"minggua_fangwei": "東四命" //命卦方位
},
"wuxing_wangdu": "水旺 木相 金休 土囚 火死", //五行旺度
"wuxing_xiji": "喜土 用火 閑金 仇水 忌木", //五行喜忌
"tiangan_liuyi": "戊癸合化火 丁戊相生 丁癸相衝 癸丁相剋", //天干留意
"dizhi_liuyi": "卯辰相害 亥卯半合木局 巳亥相衝", //地支留意
"xiyongshen": { //喜用神
"qiangruo": "八字偏弱", //八字強弱
"xiyongshen": "金，水", //以金，水為喜用神
"jishen": "水", //以水為忌神
"xiyongshen_desc": "身弱，需補助，避免剋洩耗，喜用金補水，避木忌土火。", //喜用神說明
"jin_number": 0, //五行統計 金有0個
"mu_number": 2, //五行統計 木有2個
"shui_number": 2, //五行統計 水有2個
"huo_number": 2, //五行統計 火有2個
"tu_number": 2, //五行統計 土有2個
"zidang": 3, //自黨分
"yidang": 6, //異黨分
"zidang_percent": "33.33%", //自黨占比
"yidang_percent": "66.67%", //異黨占比
"tonglei": "木火", //同類為木火
"yilei": "金水土", //異類為金水土
"rizhu_tiangan": "火", //命主五行屬火
"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": {
"sizhu_info": { //四柱資訊
"year": {
"tg_god": "傷官", //年柱資訊
"tg": "戊", //年天干十神|主星
"dz": "辰", //年地支
"cg": ["戊", "乙", "癸"], //年藏干(跟地支十神|副星一一對應)
"dz_god": ["傷官", "偏印", "七殺"], //年地支十神|副星(跟年藏干一一對應)
"dz_star_cs": "衰", //年地支十二長生|星運
"dz_self_cs": "冠帶", //年地支十二長生|自坐
"kw": "戌亥", //空亡
"ny": "大林木", //納音
"wx": "土土", //年干支五行
"xun": "甲子", //年柱所在旬
"shensha": "太極 日德" //年柱神煞
},
"month": { //月柱資訊
"tg_god": "七殺",
......
},
"day": { //日柱資訊
"tg_god": "日主",
......
},
"hour": { //時柱資訊
"tg_god": "偏印",
......
}
},
"yunshi_year_info": { //未來年運勢資訊
"yunshi_year": {
"year": 2024, //未來哪一年
"tg_god": "傷官", //此未來年天干十神
"tg": "甲", //此未來年天干
"dz": "辰", //此未來年地支
"cg": ["戊", "乙", "癸"], //此未來年藏干
"dz_god": ["正官", "食神", "比肩"], //此未來年地支藏干十神
"dz_star_cs": "養", //此未來年地支十二長生|星運
"dz_self_cs": "衰", //此未來年地支十二長生|自坐
"kw": "寅卯", //此未來年空亡
"ny": "覆燈火", //此未來年納音
"wx": "木土", //此未來年干支五行
"xun": "甲辰", //此未來年所在旬
"shensha": "空亡", //此未來年神煞
"indication": {
"shiye": "流年無神煞入命，預示命主事業運勢平平，......力和創新，尋找新的發展機遇，有望幫助事業逆轉局勢。", //此未來年事業運勢分析
"xueye": "流年無神煞入命，預示命主學業運勢平平，......逐步實現，有助於增強學業的可控性和可達性。", //此未來年學業運勢分析
"yunshi": "流年無神煞入命，預示命主近期運勢平平，......增加個人的競爭力，為將來的機遇做好準備。", //此未來年運勢分析
"yinyuan": "流年無神煞入命，預示命主姻緣運勢平平，......避免產生不必要的誤會。", //此未來年姻緣運勢分析
"caiyun": "流年無神煞入命，預示命主財富運勢平平，......尋找更為經濟實惠的方案。這有助於節省開支，提升財務狀況。",//此未來年財運運勢分析
"jiankang": "流年無神煞入命，預示命主健康運勢平平，......的睡眠對身體和心理健康都至關重要。" //此未來年健康運勢分析
}
}
},
"yunshi_month_info": [{ //分析指定的未來年中每一個月份的運勢資訊
"month": "1月",
"tg_god": "正官",
"tg": "乙",
"dz": "丑",
"cg": ["己", "癸", "辛"],
"dz_god": ["劫財", "正財", "傷官"],
"dz_star_cs": "養",
"dz_self_cs": "衰",
"kw": "戌亥",
"ny": "海中金",
"wx": "木土",
"xun": "甲子",
"shensha": "月德 福星 寡宿 天狗",
"indication": {
"shiye": "流月貴星入命，預示命主，當前事......不要被情緒左右，理性分析問題的根本原因，並尋找解決方案。",
"xueye": "流月無神煞入命，預示命主學業運......保持積極心態可以幫助你取得較好的結果。",
"yunshi": "流月神星入命，主運勢上升，有......需要更加謹慎和理智地應對。",
"yinyuan": "流月煞星入命，需注意兩人之......來理解、調整，以及在感情上保持平衡。",
"caiyun": "流月無神煞入命，預示命主財......以及對投資和支出的理性決策。",
"jiankang": "流月醫星入命，預示命主近期......有助於維護心理健康。"
},
"yunshi_day_info": [{ //分析該月下每一天的運勢資訊
"day": "1號",
"tg_god": "日主",
"tg": "丙",
"dz": "申",
"cg": ["庚", "壬", "戊"],
"dz_god": ["偏財", "七殺", "食神"],
"dz_star_cs": "病",
"dz_self_cs": "病",
"kw": "辰巳",
"ny": "山下火",
"wx": "火金",
"xun": "甲午",
"shensha": "天乙 文昌 天廚 學堂 亡神 十惡大敗",
"indication": {
"shiye": "流日貴星入命，預示命主，當前事業必......絕處逢生。",
"xueye": "流日貴星入命，主學業功名之事，預.......",
"yunshi": "流日神星入命，主運勢上升，有此......",
"yinyuan": "流日無神煞入命，預示命主姻緣......",
"caiyun": "流日財星入命，預示命主福份和......",
"jiankang": "流日無神煞入命，預示命主......"
}
},
{...} //2號
{...} //3號
....
{...} //31號
},
]
}, {
"month": "2月",
......
}, {
"month": "3月",
......
}, {
"month": "4月",
......
},
......
"month": "11月",
}, {
"month": "12月",
}]
}
}
}
失敗回傳範例
{
"errcode": -1,
"errmsg": "日期有誤",
}