韩国公共假期日历API提供了2024年至2027年韩国的官方公共假期数据,数据直接来源于韩国政府(韩国天文学和空间科学研究所)通过data.go.kr。
主要特点:
端点:
返回给定年份(2024-2027)的所有官方韩国公共假期,包括替代假期
{"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/12500/korea+public+holidays+calendar+api/23784/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/12500/korea+public+holidays+calendar+api/23785/get+korean+holidays+by+month&YEAR=Required&/=Required&MONTH=Required' --header 'Authorization: Bearer YOUR_API_KEY'
快速检查特定日期是否为韩国公共假期。请以YYYY-MM-DD格式传递日期。返回一个JSON对象,指示该日期是否为假期,并在适用时提供假期名称(英文和韩文)。对于业务逻辑、日程安排、请假/PTO计算以及任何需要知道某一天在韩国是否为工作日的应用程序都很有用。数据来源于data.go.kr。支持的日期范围:2024-01-01至2027-12-31。
{"date":"20260101","is_holiday":true,"name":"New Year's Day"}
curl --location --request GET 'https://zylalabs.com/api/12500/korea+public+holidays+calendar+api/23786/check+if+date+is+korean+holiday&DATE=Required' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
每个端点返回关于韩国的公共假期数据,包括假期名称、日期以及是否为替代假期。例如,GET /holidays/{year} 端点提供指定年份的完整假期列表
响应中的关键字段包括“日期”(YYYYMMDD格式) “年” “月” “日” “姓名”(英文) “name_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”和一个假日对象数组等字段 使得在应用中解析和使用变得简单