基礎工具-流日流時

文件說明

        通過指定的陰歷年月，計算出對應流日流時資訊以及干支納音，五行，長生，十神，藏干，納音，自坐，星運，空亡等詳細資訊。

請求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Gongju/liurishi

請求標頭 (Headers)

欄位 型別 描述
Content-Type String application/x-www-form-urlencoded

請求參數

欄位 型別 描述
api_key String 存取金鑰 (API Key)
year Int 陰歷流年 例：1999
只能傳遞陰歷流年
sort Int 排序方式 例: 1：從初一排 2：按節氣排序(推薦)
選填，如果不傳遞這個參數，預設1
month Int 陰歷流月 例：4
只能傳遞陰歷流月
注意：月在 -12～12之間，負值代表閏月，比如閏5月：-5，不考慮閏月就傳正值
sex Int 性別 0：男 1：女
bazi_type Int 八字曆法類型 0農曆 1公曆
選填，如果不傳遞這個參數，預設1
建議：若出生年包含閏月或需極高精度時，強烈推薦先呼叫【基礎工具-陰陽曆互相轉換】獲取公曆，再以 type=1 傳入。
bazi_year Int 八字出生年 例: 1988
選填，如果不傳遞這個參數，預設當前時間的年份
bazi_month Int 八字出生月 例: 8
選填，如果不傳遞這個參數，預設當前時間的月份
注意：本API不處理閏月。若該年存在閏月，請通過轉換工具獲取公曆後再行帶入。
bazi_day Int 八字出生日 例: 7
選填，如果不傳遞這個參數，預設當前時間的日
bazi_hours Int 八字出生時 例: 12
選填，如果不傳遞這個參數，預設當前時間的小時
bazi_minute Int 八字出生分 例: 30     
如果不知道具體分，可以傳數字 0。
選填，如果不傳遞這個參數，預設當前時間的分鐘
bazi_sect Int 八字流派 例：1：晚子時日柱算明天 2：晚子時日柱算當天     
選填，如果不傳遞這個參數，預設2
iszip Int 是否開啟資料壓縮(傳統壓縮模式)。例：1：是 2：否     
選填，如果不傳遞該參數，預設值為 2（返回純文字 JSON）。

⚠️ 接入必讀：
由於排盤返回的資料節點極多、報文較大，
為大幅降低網路傳輸延遲，
當 iszip=1 時，本API會在底層進行壓縮，
並直接返回 GZIP Raw Binary（原始二進位資料流）。

處理建議：
此API僅限後端呼叫。接收方拿到響應體（Response Body）後，
請勿直接進行 JSON 反序列化。
必須先使用後端語言的 GZIP 工具類對二進位資料流進行解壓縮，
解壓縮後即可得到明文 JSON 字串。

· PHP：使用 gzdecode($response) 還原
· Python：使用 gzip.decompress(response.content) 還原
· Java：使用 GZIPInputStream 包裝響應流還原
· Node.js：設定接收 arraybuffer，並使用 zlib.gunzip 還原
· Go：使用 compress/gzip 包進行讀取還原
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',
'year' => '1999',
'month' => '4',
'sex' => '0',
];

回傳參數

欄位 型別 描述
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秒" //考慮真太陽的時差
       }
    },
    "liurishi_info": [{  //流日資訊
        "liuri_index": 0,
        "liuri_day": "初一",  //第1天流日資訊
        "liuri_solar": "1999-05-15", //流日公曆資訊
        "liuri_lunar": "四月初一", //流日農曆資訊
        "liuri_ganzhi": "丁卯", //流日干支
        "liuri_xun": "甲子",      //流日所在旬
        "liuri_kongwang": "戌亥", //流日空亡
        "liuri_changsheng": "沐浴",   //長生
        "liuri_day_gan": "丁",       //天干
        "liuri_day_zhi": "卯",       //地支
        "liuri_dz_cg": [            //地支藏干
            "乙"
        ],
        "liuri_tg_god": "比肩",    //天干十神
        "liuri_dz_god": [         //地支十神
            "正官"
        ],
        "liuri_dz_star_cs": "病",  //地支十二長生|星運
        "liuri_dz_self_cs": "病",  //地支十二長生|自坐
        "liuri_nayin": "爐中火",   //納音
        "liuri_wuxing": "火木",   //五行
        "liushi_info": [{        //第1個流時資訊
            "liushi_index": 0,
            "liushi_hour": "子",
            "liushi_ganzhi": "庚子",
            "liushi_xun": "甲午",
            "liushi_kongwang": "辰巳",
            "liushi_changsheng": "胎",
            "liushi_hour_gan": "庚",
            "liushi_hour_zhi": "子",
            "liushi_dz_cg": [
                "癸"
            ],
            "liushi_tg_god": "正財",
            "liushi_dz_god": [
                "正財"
            ],
            "liushi_dz_star_cs": "絕",
            "liushi_dz_self_cs": "死",
            "liushi_nayin": "壁上土",
            "liushi_wuxing": "金水"
            "liushi_shensha": "空亡 太極 魁罡 國印 童子 十惡大敗",//流時神煞
            "liushi_tg_liuyi": "乙庚合化金 壬乙相生 戊壬相剋",    //流時天干留意
            "liushi_dz_liuyi": "辰辰自刑",                   //流時地支留意
            },
                {...},  //第2個流時資訊
                {...},  //第3個流時資訊
                        ....
                {...}   //第12個流時資訊
        ],
        "liuri_shensha": "空亡 太極 魁罡 國印 童子 十惡大敗", //流日神煞
        "liuri_tg_liuyi": "乙庚合化金 乙辛相衝 丁辛相剋",    //流日天干流意
        "liuri_dz_liuyi": "卯辰相害",                    //流日地支留意

        {...}, //第2個流日資訊
        {...}, //第3個流日資訊
        {...}, //第4個流日資訊
              ...
        {...} //最後一個流日資訊
    ],
}

失敗回傳範例

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