每日更新的靜態 JSON API
今天，放假嗎？
輸入任一日期，立即查出台灣的放假狀態、假期名稱與說明。同一份資料也能直接被程式、CLI 或 AI 代理人查詢。
選好日期後按下「查詢」，結果會顯示在這裡。
查詢中…
- 假期名稱
- -
- 分類
- -
- 說明
- -
檢視原始 JSON
命令列與 curl 範例
同一份資料可以在終端機、腳本或 CI 流程中直接查詢，不需要另外申請金鑰。
若已安裝 holidaybook CLI：
holidaybook 2025-07-20輸出：
2025-07-20：放假 類別：星期六、星期日
加上 --json 取得機器可讀的輸出，方便串接腳本：
holidaybook --json 2025-07-20輸出：
{"date":"2025-07-20","isHoliday":true,"name":"","category":"星期六、星期日","description":""}
沒有安裝 CLI 的話，直接用 curl 讀取靜態 JSON 也可以：
curl -fsS https://holiday.gh.miniasp.com/2025-07-20.json給 AI 代理人的查詢慣例
將日期代入路徑即可，不需要額外的驗證流程或請求標頭。
GET https://holiday.gh.miniasp.com/{YYYY-MM-DD}.json
isHoliday = 1 表示當天放假
isHoliday = 0 表示當天正常上班、上課
name、holidaycategory、description 可能為空字串建議代理人以 isHoliday 欄位為準，不要用「是否為週末」自行推算，因為補班日與國定假日調整都會覆寫一般的週末規則。CLI 的 --json 會把同一份資料正規化成 date（YYYY-MM-DD）、布林值 isHoliday 與 category；直接讀取靜態 JSON 時則是 YYYYMMDD、0／1 與 holidaycategory。
API 說明（機器可讀）
單日、單月、單年三種路徑共用同一個資料結構；月與年的回應是物件陣列。
- 單日
/{YYYY-MM-DD}.json例如/2025-07-20.json- 單月
/{YYYY-MM}.json例如/2025-07.json- 單年
/{YYYY}.json例如/2025.json
| 欄位 | 型別 | 說明 |
|---|---|---|
date |
string | 日期，格式為 YYYYMMDD。 |
isHoliday |
0 或 1 | 1 表示放假，0 表示正常上班上課。請直接採用此值，不要自行以星期幾推算。 |
name |
string | 國定假日或紀念日名稱，平日與例假日通常為空字串。 |
holidaycategory |
string | 假期分類，例如「星期六、星期日」或「放假之紀念日及節日」。 |
description |
string | 補充說明，可能為空字串。 |
需要留意的例外
- 軍人節只有軍人放假，本資料將它標記為非假日（
isHoliday: 0）。 - 勞動節只有勞工放假，一般行政機關與學校照常上班上課。
- 補班日會顯示為正常上班日，即使落在週六、週日。
- 超出來源日曆表已公告範圍的日期（通常是尚未公告的年度），會先以正常上班日呈現，實際放假規則仍以政府公告為準。