韓国の祝日JSON API

韓国の祝日をJSONで取得できますか? はい。2026〜2028年の官公庁祝日を、キー不要の 静的JSONで提供します。各祝日に韓国語名と英語名(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は2026〜2028年の韓国の官公庁祝日を静的JSONで提供します。全体は 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を推奨します。