## 萬年歷 >[danger]### 免費接口，每日100次免費調用，會員可不限次數調用，購買[API會員](https://market.topthink.com/product/210)  > 包含三個接口：根據日期查詢當天詳細信息、查詢近期假期和查詢當年假期。 ## 接口調用（[調用須知](https://docs.topthink.com/think-api/1835086)） ## 接口1：查詢當天詳細信息 ### 請求地址 ``` GET https://api.topthink.com/calendar/day ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | ?date| 是 | string | 指定日期,格式為YYYY-MM-DD,如月份和日期小于10,則取個位,如:2012-1-1 | ### SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->calendarDay() ->withDate('2020-8-1') ->request(); dump($result); ``` 返回示例： ~~~ { "message":"Success", "data":{ "data":{ "date":"2020-8-1", "animalsYear":"鼠", "avoid":"嫁娶.入宅.移徙.作灶.開市.交易.安門.栽種.", "lunar":"六月十二", "lunarYear":"庚子年", "suit":"祭祀.解除.沐浴.整手足甲.入殮.移柩.破土.啟攢.安葬.", "weekday":"星期六", "year-month":"2020-8" } }, "code":0 } ~~~ ## 接口2：根據傳入的月份返回近期的假期列表 ### 請求地址 ``` https://api.topthink.com/calendar/month ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | ?yearMonth| 是 | string | 指定月份,格式為YYYY-MM,如月份和日期小于10,則取個位,如:2012-1| ### SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->calendarMonth() ->withYearMonth('2020-8') ->request(); dump($result); ``` ## 接口3：根據傳入年份返回當年假期列表 ### 請求地址 ``` https://api.topthink.com/calendar/year ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | ?year| 是 | string | 指定年份,格式為YYYY,如:2015 | ### SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->calendarYear() ->withYear('2020') ->request(); dump($result); ```