傳統八字-紫微排盤
文件說明
紫微排盤是以人出生的年、月、日、時確定十二宮的位置，構成紫微命盤，結合各宮的星群組合，牽繫周易卦爻，來分析一個人的運程和吉凶禍福的趨勢。注意：本API回傳資料的gong_pan部分有12個陣列，下標從0～11，當你畫好12宮圖的時候，參考下面的圖片將對應陣列裡的所有元素放在對應宮位即可。如果紫微盤解析不符合需求的話，可以考慮結合 八字-未來運勢 的解析一起使用。
宮盤對應資料示例圖
請求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Bazi/zwpan請求標頭 (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 |
| 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
|
| sect | Int | 流派 例：1：晚子時日柱算明天 2：晚子時日柱算當天 選填，如果不傳遞這個參數，預設2 |
| 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": "張三", //姓名
"age": 36, //年齡
"gongli": "1988年11月08日12時20分", //公曆年 (如果考慮真太陽時，此處為計算後的真太陽時公曆)
"nongli": "1988年九月廿九日午時", //農曆年 (如果考慮真太陽時，此處為計算後的真太陽時農曆)
"mingsihua": "機陰貪弼", //命四化：機陰貪弼
"minggong": "辰", //命宮：辰
"shengong": "辰", //身宮：辰
"zidou": "戌", //子斗：辰
"liudou": "寅", //流斗： 寅
"mingju": "土五局", //天盤局：土五局
"mingzhu": "廉貞", //命主：廉貞
"shenzhu": "文昌", //身主：文昌
"yeargz": "戊辰", //年干支：戊辰
"monthgz": "癸亥", //月干支：癸亥
"daygz": "丁卯", //日干支：丁卯
"hourgz": "丙午", //時干支：丙午
"yearnayin": "大林木", //年納音：大林木
"monthnayin": "大海水", //月納音：大海水
"daynayin": "爐中火", //日納音：爐中火
"hournayin": "天河水" //時納音：天河水
"gendertype": "陰女", //紫微性別陰陽
},
"gong_pan": [ // 12宮盤
{ //gong_pan[0]資訊
"minggong": "疾厄宮", //命宮：疾厄宮
"yinshou": "癸亥", //寅首：癸亥
"jiangxing": "亡神", //將星：亡神
"changsheng": "臨官", //長生：臨官
"daxian": "55-64", //大限：55-64
"xiaoxian": "龍德", //小限：龍德
"boshi": "飛廉", //博士星：飛廉
"ziweixing": "", //紫微星：無
"ziweixing_xingyao": "", //紫微星星曜：無
"ziweixing_sihua": "", //紫微星四化：無
"tianfuxing": "太陰", //天府星：太陰
"tianfuxing_xingyao": "平",//天府星星曜：平
"tianfuxing_sihua": "權",//天府星四化：權
"monthxing": "", //月星：無
"monthxing_xingyao": "", //月星星曜：無
"monthxing_sihua": "", //月星四化：無
"hourxing": "", //時星：無
"hourxing_xingyao": "", //時星星曜：無
"hourxing_sihua": "", //時星四化：無
"yearganxing": "", //年干星：無
"yearganxing_xingyao": "", //年干星星曜：無
"yearganxing_sihua": "", //年干星四化：無
"yearzhixing": "紅鸞,大耗", //年支星：紅鸞，大耗
"yearzhixing_xingyao": "陷,旺", //月支星星曜：陷,旺
"yearzhixing_sihua": "", //月支星四化：無
"qitaxing": "天傷", //其他星：天傷
"qitaxing_xingyao": "", //其他星星曜：無
"qitaxing_sihua": "",, //其他星四化：無
"ziweixing_desc": "無紫微星入宮，暫無詳解", //紫微星坐在此宮解析
"tianfuxing_desc": "太陰星代表疾病和陰暗面，如果出現在疾厄宮中，可能會有一些陰暗或者不順的事情發生，身體方面也需要特別留意。" //天府星坐在此宮解析
"fuxing_desc": "此宮副星總體為兇，故不利因素加倍，有利因素減半，加煞。火星入遷移宮，若逢左右、魁鉞......",//輔星詳解
},
{ //gong_pan[1]資訊
"minggong": "財帛宮",
"yinshou": "甲子",
"jiangxing": "將星",
"changsheng": "帝旺",
"daxian": "45-54",
"xiaoxian": "白虎",
"boshi": "奏書",
"ziweixing": "",
"ziweixing_xingyao": "",
"ziweixing_sihua": "",
"tianfuxing": "貪狼",
"tianfuxing_xingyao": "平",
"tianfuxing_sihua": "祿",
"monthxing": "左輔",
"monthxing_xingyao": "平",
"monthxing_sihua": "",
"hourxing": "臺輔",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "正空",
"yearganxing_xingyao": "",
"yearganxing_sihua": "",
"yearzhixing": "",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "無紫微星入宮，暫無詳解",
"tianfuxing_desc": "貪狼星，代表野心和衝動。在財帛宮中出現，表示財富可能來源於野心和衝動，需要注意財務風險和管理。適合從事需要野心和衝動的行業，如創業、投資、競爭性行業等。"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[2]資訊
"minggong": "子女宮",
"yinshou": "乙丑",
"jiangxing": "攀鞍",
"changsheng": "衰",
"daxian": "35-44",
"xiaoxian": "天德",
"boshi": "將軍",
"ziweixing": "天同",
"ziweixing_xingyao": "旺",
"ziweixing_sihua": "",
"tianfuxing": "巨門",
"tianfuxing_xingyao": "廟",
"tianfuxing_sihua": "",
"monthxing": "",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "天魁,副空",
"yearganxing_xingyao": "陷,旺",
"yearganxing_sihua": "",
"yearzhixing": "寡宿,破碎",
"yearzhixing_xingyao": "陷,無",
"yearzhixing_sihua": "",
"qitaxing": "天貴",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "天同星，代表口才、交際和社交能力。在子女宮中出現，表示子女將來可能會擁有優秀的交際能力和口才，適合從事與人溝通和交流相關的工作，如銷售、公關等。",
"tianfuxing_desc": "巨門星，代表智慧、才華和學識。在子女宮中出現，表示子女將來可能會有很高的學術成就和專業技能，適合從事需要高水平智力和專業能力的行業，如教育、科研等。"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[3]資訊
"minggong": "夫妻宮",
"yinshou": "甲寅",
"jiangxing": "歲驛",
"changsheng": "病",
"daxian": "25-34",
"xiaoxian": "吊客",
"boshi": "小耗",
"ziweixing": "武曲",
"ziweixing_xingyao": "平",
"ziweixing_sihua": "",
"tianfuxing": "天相",
"tianfuxing_xingyao": "廟",
"tianfuxing_sihua": "",
"monthxing": "右弼,天月",
"monthxing_xingyao": "閑",
"monthxing_sihua": "科",
"hourxing": "",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "",
"yearganxing_xingyao": "",
"yearganxing_sihua": "",
"yearzhixing": "天哭,天馬",
"yearzhixing_xingyao": "無,旺",
"yearzhixing_sihua": "",
"qitaxing": "",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "武曲入夫妻宮，代表著在婚姻中有很強的競爭和進取心，但也需要注意不要讓競爭成為導致婚姻破裂的原因。",
"tianfuxing_desc": "天相入夫妻宮，代表與伴侶之間的關係比較和諧，有可能會遇到心靈契合的伴侶，但也需要注意保持自己的個性和自我價值。"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[4]資訊
"minggong": "兄弟宮",
"yinshou": "乙卯",
"jiangxing": "息神",
"changsheng": "死",
"daxian": "15-24",
"xiaoxian": "病符",
"boshi": "青龍",
"ziweixing": "太陽",
"ziweixing_xingyao": "閑",
"ziweixing_sihua": "",
"tianfuxing": "天梁",
"tianfuxing_xingyao": "陷",
"tianfuxing_sihua": "",
"monthxing": "",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "天福,天官",
"yearganxing_xingyao": "",
"yearganxing_sihua": "",
"yearzhixing": "",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "太陽入兄弟宮，代表兄弟之間很陽光且積極，經常喜歡活躍和交際，具有自信和樂觀的特點，但也可能有些自我中心，需要注意在兄弟之間的均衡發展。",
"tianfuxing_desc": "天梁入兄弟宮，代表兄弟之間可能會出現競爭和挑戰，自己也具有一定的才能和能力，但也需要注意在兄弟之間的平衡和協調，不要產生過多的爭鬥和矛盾。"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[5]資訊
"minggong": "命宮",
"yinshou": "丙辰",
"jiangxing": "華蓋",
"changsheng": "墓",
"daxian": "5-14",
"xiaoxian": "歲建",
"boshi": "力士",
"ziweixing": "",
"ziweixing_xingyao": "",
"ziweixing_sihua": "",
"tianfuxing": "七殺",
"tianfuxing_xingyao": "廟",
"tianfuxing_sihua": "",
"monthxing": "",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "文昌",
"hourxing_xingyao": "旺",
"hourxing_sihua": "",
"yearganxing": "陀羅",
"yearganxing_xingyao": "陷",
"yearganxing_sihua": "",
"yearzhixing": "華蓋",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "鈴星,三臺",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "無紫微星入宮，暫無詳解",
"tianfuxing_desc": "七殺星是一顆兇星，代表著殺氣和破壞力。七殺入命的人通常具有競爭心強、進取心強、決策果斷的特點。但是，這些人也容易陷入爭鬥和衝突中，需要注意控制自己的情緒和行為。"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[6]資訊
"minggong": "父母宮",
"yinshou": "丁巳",
"jiangxing": "劫煞",
"changsheng": "絕",
"daxian": "115-124",
"xiaoxian": "晦氣",
"boshi": "博士",
"ziweixing": "天機",
"ziweixing_xingyao": "平",
"ziweixing_sihua": "忌",
"tianfuxing": "",
"tianfuxing_xingyao": "",
"tianfuxing_sihua": "",
"monthxing": "天刑,天巫",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "地空,地劫",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "祿存",
"yearganxing_xingyao": "廟",
"yearganxing_sihua": "",
"yearzhixing": "天空,天喜,孤辰,劫殺",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "在父母宮，天機代表著智慧、計謀，善於謀略策劃，天機主人通常會受到父母的照顧和關愛，也可能具備較高的智慧和洞察力，能夠為家庭帶來好運。但也可能帶來過於謹慎、優柔寡斷的性格特點。",
"tianfuxing_desc": "無天府星入宮，暫無詳解"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[7]資訊
"minggong": "福德宮",
"yinshou": "戊午",
"jiangxing": "災煞",
"changsheng": "胎",
"daxian": "105-114",
"xiaoxian": "喪門",
"boshi": "官府",
"ziweixing": "紫微",
"ziweixing_xingyao": "旺",
"ziweixing_sihua": "",
"tianfuxing": "",
"tianfuxing_xingyao": "",
"tianfuxing_sihua": "",
"monthxing": "",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "擎羊",
"yearganxing_xingyao": "",
"yearganxing_sihua": "",
"yearzhixing": "鳳閣,解神,蜚廉",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "紫微在福德宮代表著大好機會，主要是因為紫微星是天府星的正印，天府星又與財運相關。所以，當紫微星在福德宮出現時，表明此人擁有良好的財運和事業機遇。",
"tianfuxing_desc": "無天府星入宮，暫無詳解"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[8]資訊
"minggong": "田宅宮",
"yinshou": "己未",
"jiangxing": "天煞",
"changsheng": "養",
"daxian": "95-104",
"xiaoxian": "貫索",
"boshi": "伏兵",
"ziweixing": "",
"ziweixing_xingyao": "",
"ziweixing_sihua": "",
"tianfuxing": "",
"tianfuxing_xingyao": "",
"tianfuxing_sihua": "",
"monthxing": "",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "天鉞",
"yearganxing_xingyao": "廟",
"yearganxing_sihua": "",
"yearzhixing": "",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "恩光",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "無紫微星入宮，暫無詳解",
"tianfuxing_desc": "無天府星入宮，暫無詳解"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[9]資訊
"minggong": "官祿宮",
"yinshou": "庚申",
"jiangxing": "指背",
"changsheng": "長生",
"daxian": "85-94",
"xiaoxian": "官符",
"boshi": "大耗",
"ziweixing": "",
"ziweixing_xingyao": "",
"ziweixing_sihua": "",
"tianfuxing": "破軍",
"tianfuxing_xingyao": "陷",
"tianfuxing_sihua": "",
"monthxing": "",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "封誥",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "",
"yearganxing_xingyao": "",
"yearganxing_sihua": "",
"yearzhixing": "龍池",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "火星,天才,天壽",
"qitaxing_xingyao": "陷",
"qitaxing_sihua": "",,
"ziweixing_desc": "無紫微星入宮，暫無詳解",
"tianfuxing_desc": "在官祿宮中的破軍代表著一個人的力量、戰鬥能力和進取心，通常表現為有衝勁、有闖勁、有爆發力，能夠在困難和挑戰面前勇往直前。此外，破軍也可以代表事業和財富，因此破軍強旺的人通常有著強大的事業和財富潛力。"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[10]資訊
"minggong": "奴僕宮",
"yinshou": "辛酉",
"jiangxing": "鹹池",
"changsheng": "沐浴",
"daxian": "75-84",
"xiaoxian": "小耗",
"boshi": "病符",
"ziweixing": "",
"ziweixing_xingyao": "",
"ziweixing_sihua": "",
"tianfuxing": "",
"tianfuxing_xingyao": "",
"tianfuxing_sihua": "",
"monthxing": "天姚",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "",
"hourxing_xingyao": "",
"hourxing_sihua": "",
"yearganxing": "",
"yearganxing_xingyao": "",
"yearganxing_sihua": "",
"yearzhixing": "鹹池",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "天使",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "無紫微星入宮，暫無詳解",
"tianfuxing_desc": "無天府星入宮，暫無詳解"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
},
{ //gong_pan[11]資訊
"minggong": "遷移宮",
"yinshou": "壬戌",
"jiangxing": "月煞",
"changsheng": "冠帶",
"daxian": "65-74",
"xiaoxian": "大耗",
"boshi": "喜神",
"ziweixing": "廉貞",
"ziweixing_xingyao": "廟",
"ziweixing_sihua": "",
"tianfuxing": "天府",
"tianfuxing_xingyao": "平",
"tianfuxing_sihua": "",
"monthxing": "陰煞",
"monthxing_xingyao": "",
"monthxing_sihua": "",
"hourxing": "文曲",
"hourxing_xingyao": "平",
"hourxing_sihua": "",
"yearganxing": "",
"yearganxing_xingyao": "",
"yearganxing_sihua": "",
"yearzhixing": "天虛",
"yearzhixing_xingyao": "",
"yearzhixing_sihua": "",
"qitaxing": "八座",
"qitaxing_xingyao": "",
"qitaxing_sihua": "",,
"ziweixing_desc": "在遷移宮中，廉貞星代表個人的忠誠、正義和責任心。如果廉貞星在吉位，個人在新環境中有更多機會和條件發揮自己的正義感和責任心，得到他人的尊重和信任；如果廉貞星在兇位，則可能會面臨道德和責任的問題",
"tianfuxing_desc": "在遷移宮中，天府代表了財富、資產、物質方面的變動。如果天府被帶到了遷移宮，可能意味著你將會面臨財務上的變化，可能是有意外的收入，也可能是需要花費更多的金錢去處理一些事情。"
"fuxing_desc": "此宮副星總體為吉，故諸多利因素加倍，不利因素減半，加吉。龍池入奴僕宮，主雖然表現平凡.......",//輔星詳解
}
]
}
}
}
失敗回傳範例
{
"errcode": -1,
"errmsg": "日期有誤",
}