{"year":2026,"count":22,"holidays":[{"date":"20260101","year":2026,"month":1,"day":1,"name":"New Year's Day","name_ko":"1월1일","is_holiday":true},{"date":"20260216","year":2026,"month":2,"day":16,"name":"Lunar New Year's Day","name_ko":"설날","is_holiday":true},{"date":"20260217","year":2026,"month":2,"day":17,"name":"Lunar New Year's Day","name_ko":"설날","is_holiday":true},{"date":"20260218","year":2026,"month":2,"day":18,"name":"Lunar New Year's Day","name_ko":"설날","is_holiday":true},{"date":"20260301","year":2026,"month":3,"day":1,"name":"Independence Movement Day","name_ko":"삼일절","is_holiday":true},{"date":"20260302","year":2026,"month":3,"day":2,"name":"Independence Movement Day","name_ko":"대체공휴일(삼일절)","is_holiday":true},{"date":"20260501","year":2026,"month":5,"day":1,"name":"노동절","name_ko":"노동절","is_holiday":true},{"date":"20260505","year":2026,"month":5,"day":5,"name":"Children's Day","name_ko":"어린이날","is_holiday":true},{"date":"20260524","year":2026,"month":5,"day":24,"name":"Buddha's Birthday","name_ko":"부처님오신날","is_holiday":true},{"date":"20260525","year":2026,"month":5,"day":25,"name":"Buddha's Birthday","name_ko":"대체공휴일(부처님오신날)","is_holiday":true},{"date":"20260603","year":2026,"month":6,"day":3,"name":"전국동시지방선거","name_ko":"전국동시지방선거","is_holiday":true},{"date":"20260606","year":2026,"month":6,"day":6,"name":"Memorial Day","name_ko":"현충일","is_holiday":true},{"date":"20260717","year":2026,"month":7,"day":17,"name":"제헌절","name_ko":"제헌절","is_holiday":true},{"date":"20260815","year":2026,"month":8,"day":15,"name":"Liberation Day","name_ko":"광복절","is_holiday":true},{"date":"20260817","year":2026,"month":8,"day":17,"name":"Liberation Day","name_ko":"대체공휴일(광복절)","is_holiday":true},{"date":"20260924","year":2026,"month":9,"day":24,"name":"Chuseok (Korean Thanksgiving)","name_ko":"추석","is_holiday":true},{"date":"20260925","year":2026,"month":9,"day":25,"name":"Chuseok (Korean Thanksgiving)","name_ko":"추석","is_holiday":true},{"date":"20260926","year":2026,"month":9,"day":26,"name":"Chuseok (Korean Thanksgiving)","name_ko":"추석","is_holiday":true},{"date":"20261003","year":2026,"month":10,"day":3,"name":"National Foundation Day","name_ko":"개천절","is_holiday":true},{"date":"20261005","year":2026,"month":10,"day":5,"name":"National Foundation Day","name_ko":"대체공휴일(개천절)","is_holiday":true},{"date":"20261009","year":2026,"month":10,"day":9,"name":"Hangul Proclamation Day","name_ko":"한글날","is_holiday":true},{"date":"20261225","year":2026,"month":12,"day":25,"name":"Christmas Day","name_ko":"기독탄신일","is_holiday":true}]}
curl --location --request GET 'https://zylalabs.com/api/12504/korea+public+festivities+api/23799/get+korean+public+holidays+by+year&YEAR=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"year":2026,"month":1,"count":1,"holidays":[{"date":"20260101","year":2026,"month":1,"day":1,"name":"New Year's Day","name_ko":"1월1일","is_holiday":true}]}
curl --location --request GET 'https://zylalabs.com/api/12504/korea+public+festivities+api/23800/get+korean+holidays+by+month&YEAR=Required&/=Required&MONTH=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"date":"20260101","is_holiday":true,"name":"New Year's Day"}
curl --location --request GET 'https://zylalabs.com/api/12504/korea+public+festivities+api/23801/check+if+date+is+korean+holiday&DATE=Required' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 韩国公共节日 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
韩国公共节日API提供2024年至2027年的官方公共假日数据,直接来源于韩国政府,通过data.go.kr(韩国天文学与空间科学研究所)。
主要特点:
接口:
每个端点返回韩国的公共假日数据,包括假日名称、日期以及是否为调休假日。例如,GET /holidays/{year} 端点提供指定年份的完整假日列表
响应中的关键字段包括“日期”(YYYYMMDD格式) “年” “月” “日” “名称”(英文) “名称_ko”(韩文)和“是否假日”(布尔值,指示是否是节假日)
响应数据结构为一个 JSON 对象,包含年份、假期数量和一个假期对象数组。每个假期对象包括日期、名称和是否为调休假期等具体细节
该API提供2024-2027年公共假期的信息,包括常规假期和替代假期 用户可以按年、月查询或检查特定日期
端点接受参数,例如“year”(对于GET /holidays/{year})、“month”(对于GET /holidays/{year}/{month})和“date”(对于GET /holidays/check/{date})。用户可以根据这些参数自定义请求
数据来源于韩国政府,确保其官方性和可靠性,从 data.go.kr 获取。这增强了提供的假期信息的准确性和可信度
典型用例包括规划活动 调度工作 和了解假期对韩国商业运营的影响 开发人员可以将这些数据集成到应用程序中以提高用户对假期的认识
用户可以通过解析JSON响应来提取相关的节假日信息,例如在应用程序中显示即将到来的节假日或检查特定日期是否为节假日以进行日程安排
使用 GET /holidays/check/{date} 接口,将 {date} 替换为所需的日期,格式为 YYYYMMDD。响应将指示该日期是否为公共假期,并在适用时提供假期名称
韩国公众节日API涵盖2024年至2027年的公众假期。您可以使用相应的端点查询任何这些年份的假期
是的,您可以使用GET /holidays/{year}/{month}端点来获取2024-2027年特定月份的假期。将{year}和{month}替换为所需的值
“is_holiday”字段是一个布尔值,指示该日期是否为公共假期。如果为真,则该日期被视为假期;如果为假,则不是
替代假日包含在假日列表中,“name”字段指示假日的名称,“name_ko”字段显示韩语名称。“is_holiday”字段对于这些日期也将为真
如果API在特定月份返回一个空数组,则意味着该月份没有公共假期。您可以在应用程序中处理此场景,通过显示一条消息指示没有假期可用
API通过响应中的"name"字段返回假期名称的英语。确保您解析此字段以在应用程序中正确显示假期名称
该API以JSON格式返回数据 每个响应包含一个结构化对象 其中字段包括"year" "count"和一个假日对象数组 使其在应用程序中易于解析和使用