基礎工具-擇吉日

文件說明

        通過指定的未來時間範圍,以及需要的擇事,列出對應未來一段時間符合該擇事的吉日資訊。建議查詢最好先通過本API取日之忌宜,再通過老黃曆API獲取更為詳細的時之忌宜。

請求方式

POST GET

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

請求標頭 (Headers)

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

請求參數

欄位 型別 描述
api_key String 存取金鑰 (API Key)
future Int 未來時間範圍 例:0.未來7天 1.未來半個月 2.未來1個月 3.未來3個月
非必須參數,預設0
incident Int 擇何事 例:0.遷徙|搬家 1.修造|裝修 2.入宅 3.納采|訂婚|結婚
4.嫁娶|領證 5.求嗣|破腹產 6.納財 7.開市
8.交易 9.置產 10.動土 11.出行
12.安葬 13.祭祀 14.祈福 15.沐浴
16.訂盟 17.納婿 18.修墳 19.破土
20.安葬 21.立碑 22.開生墳 23.合壽木
24.入殮 25.移柩 26.伐木 27.掘井
28.掛匾 29.栽種 30.入學 31.理發
32.會親友 33.赴任 34.求醫 35.治病
非必須參數,預設0
lang String 多語言:zh-cn 、zh-tw     
選填,如果不傳遞這個參數,預設為 zh-cn

請求參數範例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'future' => '1',
'incident' => '3',
];

回傳參數

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

成功回傳範例

{
    "errcode": 0,
    "errmsg": "請求成功",
    "notice": "本次測算結果僅供娛樂使用,請勿用於封建迷信和違法用途。",
    "data": {
        "detail_info": [
            {
                "yangli": "2023-12-12", //陽曆
                "yinli": "二〇二三年十月三十日(農曆)",  //陰歷
                "ganzhi": {
                    "yeargan": "癸",     //年干
                    "yearzhi": "卯",     //年支
                    "monthgan": "甲",    //月干
                    "monthzhi": "子",    //月支
                    "daygan": "甲",      //日干
                    "dayzhi": "辰",      //日支
                    "timegan": "己",     //時干
                    "timezhi": "巳"      //時支
                },
                "wuxing": "金箔金(年) 海中金(月) 覆燈火(日)",   //五行納音
                "chongsha": "沖(戊戌)狗煞南",                 //沖煞
                "baiji": "甲不開倉財物耗散 辰不哭泣必主重喪",     //彭祖百忌
                "xingxiu": "翼蛇兇",                         //星宿
                "xingxiuge": "翼星不利架高堂,三年二載見瘟惶,埋葬若還逢此日,子孫必定走他鄉,婚姻此日不宜利,歸家定是不相當,開門放水家須破,少女戀花貪外郎。", //星宿歌
                "guishenfangwei": "陽貴神:西南 陰貴神:東北",  //貴神方位
                "xishenfangwei": "東北",                    //喜神方位
                "fushenfangwei": "正北",                    //福神方位
                "caishenfangwei": "東北",                   //財神方位
                "benyuetaishen": "占房床",                  //本月胎神
                "jinritaishen": "門碓棲 房內東",             //今日胎神
                "zhixing": "定",                            //值星
                "jishen": "月德 四相 陽德 解神 司命 ",          //吉神
                "xiongshen": "小耗 天賊 土符 ",               //兇神
                "xingqi": "星期二",
                "liuyao": "先負",                           //六曜
                "qizheng": "火",                           //七曜 又稱七政
                "wuhou": "虎始交",                          //物候
                "gongshou": "南方朱雀",                     //四宮+神獸
                "yuexiang": "晦",                          //月相
                "jieqi": "無",                             //節氣,如果有節氣顯示對應節氣,比如冬至,如果沒有就顯示無
                "tianshen": "天牢",                        //獲取當日的天神
                "huanghei": "黑道",                        //獲取當日的天神是黃道還是黑道
                "jixiong": "兇",                          //獲取當日的天神是吉還是兇
                "yi": "求嗣 齋醮 塑繪 訂盟 納采 出火 拆卸 修造 動土 造橋 安機械 栽種 納畜 牧養 入殮 除服 成服 移柩 破土 安葬 ", //本日宜
                "ji": "開市 嫁娶 "  //本日忌
            },
            {
                "yangli": "2023-12-13",
                "yinli": "二〇二三年冬月初一日(農曆)",
                "ganzhi": {
                    "yeargan": "癸",
                    "yearzhi": "卯",
                    "monthgan": "甲",
                    "monthzhi": "子",
                    "daygan": "乙",
                    "dayzhi": "巳",
                    "timegan": "辛",
                    "timezhi": "巳"
                },
                "wuxing": "金箔金(年) 海中金(月) 覆燈火(日)",
                "chongsha": "沖(己亥)豬煞東",
                "baiji": "乙不栽植千株不長 巳不遠行財物伏藏",
                "xingxiu": "軫蚓吉",
                "xingxiuge": "軫星臨水造龍宮,代代為官受皇封,富貴榮華增壽祿,庫滿倉盈自昌隆,埋葬文昌來照助,宅舍安寧不見兇,更有為官沾帝寵,婚姻龍子入龍宮。",
                "guishenfangwei": "陽貴神:西南 陰貴神:正北",
                "xishenfangwei": "西北",
                "fushenfangwei": "西南",
                "caishenfangwei": "東北",
                "benyuetaishen": "占竈爐",
                "jinritaishen": "碓磨床 房內東",
                "zhixing": "執",
                "jishen": "四相 五富 益後 ",
                "xiongshen": "劫煞 小耗 重日 元武 ",
                "xingqi": "星期三",
                "liuyao": "大安",
                "qizheng": "水",
                "wuhou": "虎始交",
                "gongshou": "南方朱雀",
                "yuexiang": "朔",
                "jieqi": "無",
                "tianshen": "玄武",
                "huanghei": "黑道",
                "jixiong": "兇",
                "yi": "嫁娶 訂盟 納采 祭祀 祈福 修造 動土 移徙 入宅 ",
                "ji": "開市 安葬 "
            }
        ],
        "base_info": {
            "summarize": "吉日區間:2023-12-06——2023-12-20,共計15天,其中適合納采的吉日有 2 天"
        }
    }
}
                

失敗回傳範例

{
  "errcode": -1,
  "errmsg": "日期有誤",
}