韓國公休日JSON API

可以用JSON取得韓國公休日嗎? 可以。以免金鑰的靜態JSON提供2026〜2028年政府公休日, 每個公休日都含韓文名稱與英文名稱(name_en)。

端點

用途路徑 (GET)
全部/holidays.json
各年度/api/holidays/{year}.json

可用年度: 2026, 2027, 2028。Content-Type 為 application/json。

欄位

欄位說明
date公休日日期 "YYYY-MM-DD"
name韓文名稱
name_en英文名稱
typepublic · substitute · election
weekday星期 0=日 … 6=六
verified未確定則為 false

回應範例

{
  "country": "KR",
  "source": "Korea Astronomy and Space Science Institute almanac (월력요항); 관공서의 공휴일에 관한 규정",
  "checkedAt": "2026-11-05",
  "note": "2028 holidays were not cross-checked against the original 2028 almanac (lunar dates verified via conversion and third-party calendars). 2027 and 2028 election days and temporary holidays are not included.",
  "note_ko": "2028년 공휴일은 2028 월력요항 원문 미대조(음력 날짜는 변환 알고리즘·해외 달력 교차 확인). 2027·2028년 선거일·임시공휴일 미반영",
  "year": 2026,
  "years": [
    2026,
    2027,
    2028
  ],
  "verified": true,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "신정",
      "name_en": "New Year's Day",
      "type": "public",
      "weekday": 4,
      "verified": true
    },
    {
      "date": "2026-02-16",
      "name": "설날 연휴",
      "name_en": "Seollal Holiday",
      "type": "public",
      "weekday": 1,
      "verified": true
    }
  
    // … 省略 …
  ]
}

來源・授權

來源: Korea Astronomy and Space Science Institute almanac (월력요항); 관공서의 공휴일에 관한 규정。日期與名稱為公開事實值,並非複製原文表格。確認日 2026-11-05。

未來年度可能變動(未確定項目標示 verified:false)。2028年公休日未與2028年曆要項原文核對(農曆日期以換算演算法與境外日曆交叉確認)。尚未納入2027與2028年選舉日及臨時公休日

完整欄位說明與CORS細節請參閱 英文版文件。

常見問題

可以用JSON取得韓國公休日嗎?

可以。Hyuilmoa以靜態JSON提供2026〜2028年韓國政府公休日。全部為 https://hyuilmoa.com/holidays.json,各年度為 https://hyuilmoa.com/api/holidays/{year}.json,直接GET即可。每個公休日都含韓文名稱(name)與英文名稱(name_en)。

需要API金鑰嗎?

不需要。這是無須金鑰或註冊即可GET的靜態檔案,也沒有速率限制。

可以直接從瀏覽器fetch嗎?

因為是靜態檔案,網站端無法附加CORS標頭。若主機(CloudFront/S3)設定Access-Control-Allow-Origin即可直接fetch,否則建議用伺服器端fetch。