{"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/12502/korea+official+holidays+api/23793/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/12502/korea+official+holidays+api/23794/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/12502/korea+official+holidays+api/23795/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年的公共假期信息,包括法定假日和替代假日 用户可以按年、月查询或检查特定日期
端点接受参数,如“年”(用于GET /holidays/{year})、“月”(用于GET /holidays/{year}/{month})和“日期”(用于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”和一个假日对象数组等字段 使得在应用中解析和利用变得简单