術數排盤-星座星盤(舊版API,已暫停維護)
文件說明
本API為早期星座星盤方案,主要用於兼容歷史接入系統,當前已暫停功能迭代與能力擴展,不再作為推薦API對外推廣。
舊版API僅基於基礎星體與相位進行點位計算與簡易資訊輸出,解讀內容以單一星體關係為主,未包含西方占星完整本命星盤體系,也不提供宮位聯動、全盤格局的綜合解讀分析能力。
如用於正式產品、商業化場景或內容長期運營,強烈建議使用平臺最新提供的 西方占星 - 本命星盤 API。該API計算精度更高,覆蓋完整本命占星體系,並提供更加穩定、全面的綜合解讀結果,適用於推薦系統、內容展示及會員制場景。
請求方式
POST
GET
https://api.yuanfenju.com/index.php/v1/Liupan/xingpan
請求標頭 (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 |
| geolimits | Int | 地理範圍 例:1:中國(需強制傳遞省和市) 2:世界(需強制傳遞經緯度) 選填,如果不傳遞這個參數,預設1 |
| province | String | 省 例:北京市 如果 geolimits為 1 時則必填,點擊此處了解省市列表 |
| city | String | 市 例:北京 如果 geolimits為 1 時則必填,點擊此處了解省市列表 |
| longitude_degree | Int | 經度-度數 例:20 如果 geolimits為 2 時則必填,度數範圍只能是在0~180之間的整數數字 |
| longitude_minutes | Int | 經度-分數 例:20 如果 geolimits為 2 時則必填,分數範圍只能是在0~59之間的整數數字 |
| longitude_type | String | 經度-型別 例:E 如果 geolimits為 2 時則必填,範圍 "E","W" 二選一 |
| latitude_degree | Int | 緯度-度數 例:20 如果 geolimits為 2 時則必填,度數範圍只能是在0~90之間的整數數字 |
| latitude_minutes | Int | 緯度-分數 例:20 如果 geolimits為 2 時則必填,分數範圍只能是在0~59之間的整數數字 |
| latitude_type | String | 緯度-型別 例:S 如果 geolimits為 2 時則必填,範圍 "S","N" 二選一 |
| timezone | Int | 時區 例:8 選填,範圍 -12~14 之間,如果不傳遞這個參數,預設8 |
| isdst | Int | 是否日光節約時間 (DST) 例:0:否 1:是 選填,如果不傳遞這個參數,預設0 |
| image_type | Int | 返回星盤圖片的樣式型別 例:1:第1種樣式 2:第2種樣式 選填,如果不傳遞這個參數,預設2 |
| image_type_background_R | Int | 星盤背景顏色程式碼R 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設255 |
| image_type_background_G | Int | 星盤背景顏色程式碼G 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設255 |
| image_type_background_B | Int | 星盤背景顏色程式碼B 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設255 |
| image_type_circle_rectangle | Int | 星盤是否保留矩形背景(僅適用於image_type=2的情況)
例:1:不保留 2:保留 選填,範圍 1~2 之間,如果不傳遞這個參數,預設2 |
| image_type_line_R | Int | 星盤線條顏色程式碼R(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設0 |
| image_type_line_G | Int | 星盤線條顏色程式碼G(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設0 |
| image_type_line_B | Int | 星盤線條顏色程式碼B(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設0 |
| image_type_outercircle_R | Int | 星盤外圈顏色程式碼R(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設255 |
| image_type_outercircle_G | Int | 星盤外圈顏色程式碼G(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設255 |
| image_type_outercircle_B | Int | 星盤外圈顏色程式碼B(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設204 |
| image_type_innercircle_R | Int | 星盤內圈顏色程式碼R(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設153 |
| image_type_innercircle_G | Int | 星盤內圈顏色程式碼G(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設255 |
| image_type_innercircle_B | Int | 星盤內圈顏色程式碼B(僅適用於image_type=2的情況) 例:255 選填,範圍 0~255 之間,如果不傳遞這個參數,預設153 |
| width | Int | 返回星盤圖片的寬度 例:480 選填,範圍 480, 640, 720, 800 四選一,如果不傳遞這個參數,預設640 |
| height | Int | 返回星盤圖片的高度 例:480 選填,範圍 480, 640, 720, 800 四選一,如果不傳遞這個參數,預設640 |
| lang | String | 多語言:zh-cn 、en-us 、zh-tw 選填,如果不傳遞這個參數,預設為 zh-cn |
請求參數範例
$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'name' => '張三',
'sex' => '0',
'type' => '1',
'year' => '1980',
'month' => '12',
'day' => '3',
'hours' => '12',
'minute' => '5',
'geolimits' => '1',
'province' => '北京市',
'city' => '北京',
'image_type'=>'2',
'width'=>'480',
'height'=>'480',
];
回傳參數
| 欄位 | 型別 | 描述 |
|---|---|---|
| errcode | String | 狀態碼 0成功 其它為失敗 |
| errmsg | String | 狀態碼說明 |
| notice | String | 聲明 |
| data | Json | 資料內容 |
成功回傳範例
{
"errcode": 0,
"errmsg": "請求成功",
"notice": "本次測算結果僅供娛樂使用,請勿用於封建迷信和違法用途。",
"data": {
"xing_info": [ //第1個星體落入星座資訊(總計10個星體陣列)
{
"xingti": "太陽", //星體名
"fall_xingzuo": { //落入星座
"name": "射手座", //太陽落入射手座
"angle": {
"deg": "11", //太陽落入射手座度數的度資訊
"min": "09", //太陽落入射手座度數的分資訊
"sec": "11" //太陽落入射手座度數的秒資訊
},
//太陽落入射手座解析
"description": "太陽在射手座的人以冒險精神和自由渴望而著稱。他們充滿活力,樂觀開朗,對生活抱有積極的態度。太陽射手喜歡探索新領域,追求知識和真理,對世界有極大的好奇心。這種渴望擴展邊界的性格使他們在旅行、哲學和教育方面表現出色。然而,他們可能因為過於樂觀或急於追求新事物而忽視現實和責任。在成長過程中,學習保持夢想與實踐之間的平衡,有助於他們在追求個人自由的同時,實現更為長遠的目標。通過傾聽他人的意見和增強細緻思維,他們能在冒險中獲得更多有意義的經驗。當他們在生活中找到歸屬感和穩定性時,太陽射手能夠更有效地利用其熱情和洞察力,產生積極的影響。"
},
"fall_gong": { //落入宮位
"name": "1宮", //太陽落入第一宮
"angle": {
"deg": "05", //太陽落入第一宮度資訊
"min": "45", //太陽落入第一宮分資訊
"sec": "25" //太陽落入第一宮秒資訊
},
//太陽落入第一宮解析
"description": "太陽落在第一宮的人通常會自信滿滿,並且很注意自己在他人眼中的形象。你常常擁有強烈的個性,傾向於成為領導者或在群體中扮演重要角色。這種設定的人渴望得到別人的認可和尊重,因此你會努力地展現自己的優勢和獨特之處。太陽在此宮位的人極具表現力,通常會在人群中脫穎而出,並在各種社交場合中顯得如魚得水。然而,你也可能因為過於關注自我形象而忽視他人的感受,需要注意平衡自己的自信和顧忌他人意見的關係。"
},
//是否逆行 N否 Y是
"is_ret": "N"
},
{......}, //第2個星體落入星座資訊
{......}, //第3個星體落入星座資訊
{......},
......
{......},//第10個星體落入星座資訊
],
"gong_info": [ //各宮位置資訊(總計12個宮位陣列)
{
"gongwei": "1宮", //第1宮資訊
"fall_xingzuo": {
"name": "射手座", //第1宮落在射手座
"angle": {
"deg": "05", //第1宮落在射手座的度資訊
"min": "23", //第1宮落在射手座的分資訊
"sec": "46" //第1宮落在射手座的秒資訊
},
////第1宮落在射手座的解析
"description": "命宮在射手座,體現了你天生熱情、樂觀和自由奔放的個性。你追求廣闊的視野和精神的成長,總是渴望探索未知的領域。射手座賦予了你強烈的冒險精神,讓你對生活充滿好奇心與期待。你喜歡無拘無束的生活方式,在旅途中尋找到內心的平衡。對於目標的追求,你不輕易妥協,敢於突破邊界,實現理想。然而,有時你的過度樂觀可能讓你忽略現實中的細節。建議你學會在激情與務實之間找到平衡,這樣你的行動將更加高效。適合的職業包括教育、旅遊、國際貿易以及哲學相關的領域。"
}
},
{......}, //第2宮資訊
{......}, //第3宮資訊
{......}, //第4宮資訊
......
{......}, //第12宮資訊
],
"xiang_info": [ //第1個相位資訊(相位陣列不固定)
{
"xingti1": "太陽", //星體1
"xingti2": "木星", //星體2
"xiangwei": "六合", //星體1和星體2的相位
"fangxiang": "出相", //方向
"orb": { //容許度 (Orb)資訊
"deg": "04", //容許度 (Orb)
"min": "48", //容許分
"sec": "30" //容許秒
},
//相位資訊的解析
"description": "當太陽與木星形成六合相位時,個人的信心和成長機會之間的狀態變得尤為積極。太陽代表著自我表現與生命力,木星則象徵著擴展、好運和哲學信仰。這個相位帶來個人對未來的樂觀態度和對多樣知識的渴求,使得個體在個人發展和事業拓展中具備天然的吸引力與領導氣質。它往往為人開啟更多開拓視野、增長學識與獲取成功的良機。如若善加利用,這一相位助力個體在追求高遠目標時更具信念,時時吸取和融合新的思想,使生活和事業的每一步都朝向更大的成功邁進。與此同時,這種相位結構有利於培養慈善與仁愛的精神,使個人的生活更加豐富多樣,充滿正能量。"
},
{......}, //第2個相位資訊
{......}, //第3個相位資訊
{......},
{......},
......
{......}, //第N個相位資訊,N為多少不固定。
],
"four_axis_info": { //四軸資訊
"asc": { //上升資訊
"fall_xingzuo": {
"name": "射手座", //上升射手座
"angle": {
"deg": "05",
"min": "23",
"sec": "46"
},
"description": "上升在射手座的人通常以樂觀、熱情和冒險精神著稱,他們富有哲學性,喜歡追求新知和自由。射手上升表明個體具備開放的心態,對文化和思想的交流滿懷興趣。他們以積極樂觀的態度面對生活,崇尚自由和廣闊的空間,喜歡並善於旅行和探索。然而,容易被過度的野心和自由衝動所支配,使得他們有時顯得缺乏耐力或對責任的忽視。在成長過程中,上升射手需平衡追求夢想與穩固生活基礎。通過結合冒險精神與實際努力,他們能夠在理解地球界限的同時壯大個人見識。在面對長遠目標時,融入更加細緻的規劃和持久努力,將幫助他們在自由和值得仰望的成就中獲取豐富經驗。"
}
},
"mc": { //天頂 (Midheaven/MC)資訊
"fall_xingzuo": {
"name": "處女座", //天頂 (Midheaven/MC) 處女座
"angle": {
"deg": "22",
"min": "26",
"sec": "39"
},
"description": "天頂 (Midheaven/MC) 處女座的人通常在職業事業中展現出對細節的關注和對工作的責任心。他們傾向於追求高標準和卓越的成就,能在細心和有條理的基礎上打下穩固的職業根基。在領域和團隊中,他們扮演完善和提高整體效率的角色。然而,過度追求完美和對自己或他人嚴苛的標準,可能導致他們疲憊不堪。學習在卓越追求和實際條件中取得平衡至關重要。他們的職業成功常緣於通過適應與改良入手提供實際價值。通過開放心態和團隊協作,他們能夠優化和創新工作流程。公眾通常視天頂 (Midheaven/MC) 處女座的人為勤勉的榜樣,並信任他們會一如既往承擔起所承諾的重義務。"
}
},
"dsc": { //下降資訊
"fall_xingzuo": {
"name": "雙子座", //下降雙子座
"angle": {
"deg": "05",
"min": "23",
"sec": "46"
},
"description": "下降在雙子座的人吸引的是聰慧、多變和健談的伴侶。這樣的人能提供多樣的觀點和靈活的互動方式,讓生活充滿活力。儘管他們自己可能更傾向於深度或專注,但由於尋找的是知識渴求和溝通能力強的人,這為關係帶來了一種思想多元化的活力。在此組合中,交流是關鍵元素,夥伴之間的良好互動和資訊交流有助於構建穩固的關係。需要警惕的是關係中可能出現的表面化或不穩定的問題。通過發展耐心和深入理解,他們能夠在持續的溝通中達到關心和親密。建設健康關係,兩人需相互給予空間並尊重彼此的求知慾,在對話中形成穩定關係的基石。"
}
},
"ic": { //天底 (Imum Coeli/IC)資訊
"fall_xingzuo": {
"name": "雙魚座", //天底 (Imum Coeli/IC)雙魚座
"angle": {
"deg": "22",
"min": "26",
"sec": "39"
},
"description": "天底 (Imum Coeli/IC)在雙魚座的人渴望一個充滿夢幻、靈性和無條件愛的家庭環境,在那裡可以展現最真實的自我。成長可能伴隨著敏感的情感氛圍,使得他們渴望在家中營造如夢似幻、富有創造力和情感支援的生活。然而,受情感驅動的生活可能導致實質安全感的缺乏。面臨個人發展和家庭責任的挑戰時,他們需要在靈感和實際生活選項之間做出調整。通過在價值觀上體驗現實與精神的結合,他們能在家庭構建中保持真實,並提供靈活包容的家園空間,賦予每一段家庭關係內心平衡與成長機會。"
}
}
},
"base_info": { //基本資訊
"sex": "男", //性別
"name": "張三", //姓名
"gongli": "1980-12-03 12:05:00", //公曆出生時間
"nongli": "一九八〇年十月廿六日 午時",//農曆出生時間
"shengxiao": "猴", //生肖
"xingzuo": "射手", //星座
"jingdu": "39.67", //出生經度
"weidu": "40.83", //出生緯度
"shicha": "8", //時區
"lingshu": "6" //生命靈數
},
//星盤排盤訪問URL地址 (有效期300秒)
"image_url": "******"
}
}
失敗回傳範例
{
"errcode": -1,
"errmsg": "日期有誤",
}