術數排盤-金口訣排盤

文件說明

        金口訣排盤，金口訣是中國古代的一種高級術數，它融合了太乙、奇門、六壬、三式絕學的精華。學會金口訣，凡事不用問。金口訣以干支體系為基礎，與現代的時間、空間、人體五臟六腑、十二經絡完全吻合，所以能夠更好地運用於現代生活，解讀人事與健康。

請求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Liupan/jinkoujue

請求標頭 (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 傳入。
born_year Int 出生年 例: 1988
year Int 起盤年 例: 1988
month Int 起盤月 例: 8
注意：本API不處理閏月。若該年存在閏月，請通過轉換工具獲取公曆後再行帶入。
day Int 起盤日 例: 7
hours Int 起盤時 例: 12
minute Int 起盤分 例: 30     
如果不知道具體分，可以傳數字 0
jiang_model Int 換將方式 例：0：交節換將 1：中氣換將    
選填，如果不傳遞這個參數，預設0
gui_model Int 貴人方式 例：0：甲羊戊庚牛 1：甲戊庚牛羊    
選填，如果不傳遞這個參數，預設1
gui_xing_model Int 貴人行運 例：0：夜 1：晝 2：自動卯酉分    
選填，如果不傳遞這個參數，預設2
hang_year Int 是否排行年 例：0：否 1：是    
選填，如果不傳遞這個參數，預設0
difen_model Int 地分方式 例：1：選定 2：報數 3：隨機數    
選填，如果不傳遞這個參數，預設3
difen_model_value Int 地分值     
如果 difen_model 為1時，此參數為必填，只能傳遞：亥、子、丑、寅、
卯、辰、巳、午、未、申、酉、戌十二地支任意一個。例：卯
如果 difen_model 為2時，此參數為必填，只能傳遞大於等於0的數字。例：23
如果 difen_model 為3時，此參數選填。
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     
選填，如果不傳遞這個參數，預設為 zh-cn

請求參數範例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'name' => '張三',
'sex' => '0',
'type' => '1',
'born_year' => '1990',
'year' => '2024',
'month' => '3',
'day' => '30',
'hours' => '10',
'minute' => '0',
'zhen' => '1',
'province' => '北京市',
'city' => '北京',
];

回傳參數

欄位 型別 描述
errcode String 狀態碼 0成功 其它為失敗
errmsg String 狀態碼說明
notice String 聲明
data Json 資料內容

成功回傳範例

{
	{
	"errcode": 0,
	"errmsg": "請求成功",
	"notice": "本次測算結果僅供娛樂使用，請勿用於封建迷信和違法用途。",
	"data": {
		"name": "張三",
		"sex": "乾造",
		"gongli": "2024年03月30日09時45分",	//公曆起盤時間
		"nongli": "2024年二月廿一日巳時",		//農曆起盤時間
		"jieqi": "2024年03月05日10時22分驚蟄",	//節氣
		"xunkong": "午未",	//旬空
		"kongwang": "金空",	//四大空亡
		"yuejiang": "戌將",	//月將
		"hangnian": "--", //行年，只有 hang_year 為1時 這裡才有值，否則只有 "--"
		"nianming": "--", //年命，只有 hang_year 為1時 這裡才有值，否則只有 "--"
		"shensha": {		//神煞
			"guiren": "卯、巳",	//貴人-卯、巳
			"rilu": "子",		//日祿-子
			"yima": "亥",		//驛馬-亥
			"taohua": "午"		//桃花-午
		},
		"sizhu_info": {			//四柱資訊
			"year_gan": "甲",	//年干
			"year_zhi": "辰",	//年支
			"month_gan": "丁",	//月干
			"month_zhi": "卯",	//月支
			"day_gan": "癸",		//日干
			"day_zhi": "巳",		//日支
			"hour_gan": "丁",	//時干
			"hour_zhi": "巳",		//時支
		},
		"pan_info": {			//金口訣盤資訊
			"renyuan_info": {	//人元資訊
				"ganzhi": "丙",	//人元干支
				"shuaiwang": "旺" //人元衰旺
			},
			"guishen_info": {	 //貴神資訊
				"ganzhi": "丁巳",	//貴神干支
				"name": "螣蛇",		//貴神名
				"shuaiwang": "旺",	//貴神衰旺
				"yongyao": ""		//用爻資訊，如果為空則非此處用爻，如果非空則此處用爻
			},
			"jiangshen_info": {		//將神資訊
				"ganzhi": "辛酉",	//將神干支
				"name": "從魁",		//將神名
				"shuaiwang": "死",	//將神衰旺
				"yongyao": "用爻"	//用爻資訊，如果為空則非此處用爻，如果非空則此處用爻
			},
			"difen_info": {			//地分資訊
				"ganzhi": "辰",		//地分干支
				"shuaiwang": "相"	//地分衰旺
			}
		},
		"zhen": {	//考慮真太陽時才會有此欄位，不考慮真太陽時就沒有這個欄位
			"province": "北京市", //真太陽時省市
			"city": "北京",		//真太陽時省市
			"jingdu": "116.46",	//真太陽經度
			"weidu": "39.92",	//真太陽緯度
			"shicha": "晚0小時14分10秒"	//考慮真太陽的時差
		}
	}
}

失敗回傳範例

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