Días festivos públicos de Corea con lógica de días festivos sustitutos además de la romanización revisada y precisa del texto coreano en una API JSON rápida y sin dependencias en un edge global Verifica si alguna fecha es un día festivo público enumera los días festivos de un año romaniza Hangul o obtiene la fecha y el estado del día de Corea de hoy Conversión lunar-solar los 24 términos solares y el ciclo sexagenario llegarán en v1.1
{
"year": 2026,
"count": 19,
"holidays": [
{
"date": "2026-01-01",
"name": "신정",
"name_en": "New Year's Day",
"substitute": false
},
{
"date": "2026-02-16",
"name": "설날 연휴",
"name_en": "Seollal Holiday",
"substitute": false
},
{
"date": "2026-02-17",
"name": "설날",
"name_en": "Seollal (Lunar New Year)",
"substitute": false
},
{
"date": "2026-02-18",
"name": "설날 연휴",
"name_en": "Seollal Holiday",
"substitute": false
},
{
"date": "2026-03-01",
"name": "삼일절",
"name_en": "Independence Movement Day",
"substitute": false
},
{
"date": "2026-03-02",
"name": "대체공휴일",
"name_en": "Substitute Holiday",
"substitute": true
},
{
"date": "2026-05-05",
"name": "어린이날",
"name_en": "Children's Day",
"substitute": false
},
{
"date": "2026-05-24",
"name": "부처님오신날",
"name_en": "Buddha's Birthday",
"substitute": false
},
{
"date": "2026-05-25",
"name": "대체공휴일",
"name_en": "Substitute Holiday",
"substitute": true
},
{
"date": "2026-06-06",
"name": "현충일",
"name_en": "Memorial Day",
"substitute": false
},
{
"date": "2026-08-15",
"name": "광복절",
"name_en": "Liberation Day",
"substitute": false
},
{
"date": "2026-08-17",
"name": "대체공휴일",
"name_en": "Substitute Holiday",
"substitute": true
},
{
"date": "2026-09-24",
"name": "추석 연휴",
"name_en": "Chuseok Holiday",
"substitute": false
},
{
"date": "2026-09-25",
"name": "추석",
"name_en": "Chuseok (Korean Thanksgiving)",
"substitute": false
},
{
"date": "2026-09-26",
"name": "추석 연휴",
"name_en": "Chuseok Holiday",
"substitute": false
},
{
"date": "2026-10-03",
"name": "개천절",
"name_en": "National Foundation Day",
"substitute": false
},
{
"date": "2026-10-05",
"name": "대체공휴일",
"name_en": "Substitute Holiday",
"substitute": true
},
{
"date": "2026-10-09",
"name": "한글날",
"name_en": "Hangeul Day",
"substitute": false
},
{
"date": "2026-12-25",
"name": "크리스마스",
"name_en": "Christmas Day",
"substitute": false
}
],
"source": "Holiday dates: statutory KR public holidays (sync KASI 특일정보, data.go.kr, KOGL Type 1)."
}
curl --location --request GET 'https://zylalabs.com/api/12758/korea+calendar+api/24839/list+public+holidays?year=2026' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Calendario de Corea API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento.
(Ahorra 2 meses pagando anualmente 🎉)
La API del calendario de Corea te ofrece datos precisos del calendario coreano y romanización coreana a través de una API rápida, en JSON y sin dependencias que funciona en un borde global.
AHORA EN VIVO
PUNTOS DE ACCESO
GET /v1/holidays?year=2026
GET /v1/holidays/is?date=2026-09-25
GET /v1/romanize?text=TITULO_TU_TEXTO
GET /v1/today
PRÓXIMO EN v1.1
Conversión lunar-solar, los 24 términos solares y el ciclo sexagenario - datos que las APIs globales de festivos no proporcionan.
PARA QUIÉN ES
Aplicaciones que sirven a Corea, productos de K-cultura y K-pop, herramientas de programación y recursos humanos, y aplicaciones de calendario o astrología que necesitan días festivos coreanos correctos y una romanización clara.
Las fechas de los días festivos son días festivos legales en Corea del Sur (fuente: datos de días festivos de KASI a través de data.go.kr).
Cada punto final devuelve datos específicos relacionados con los días festivos públicos de Corea, la romanización del Hangul y las conversiones de fechas. Por ejemplo, el punto final de las fiestas proporciona una lista de días festivos para un año determinado, mientras que el punto final de romanización convierte el texto en Hangul en Romanización revisada
Los campos clave incluyen "fecha" "nombre" (coreano) "nombre_en" (inglés) "sustituto" (booleano) y para las conversiones lunares "año_lunar" "mes_lunar" y "día_lunar" Estos campos proporcionan información esencial sobre las festividades y las conversiones de fechas
Los puntos finales aceptan parámetros como "año" para el punto final de festividades "fecha" para comprobar si una fecha es un día festivo o para conversiones lunares y "texto" para romanización Los usuarios pueden personalizar las solicitudes especificando estos parámetros
Los datos de respuesta están estructurados en formato JSON Por ejemplo el endpoint de vacaciones devuelve un objeto que contiene el año la cantidad de vacaciones y un arreglo de objetos de vacaciones cada uno con campos relevantes como fecha y nombres en ambos idiomas
Los datos provienen de la información sobre días festivos de KASI a través de data.go.kr, asegurando que la información sobre los días festivos sea precisa y esté actualizada. Esta fuente confiable contribuye a la calidad de los datos de la API
Los casos de uso típicos incluyen la integración de información sobre las festividades coreanas en aplicaciones, herramientas de programación y sistemas de recursos humanos Los desarrolladores también pueden utilizar la función de romanización para aplicaciones de aprendizaje de idiomas o plataformas de cultura K para mejorar la experiencia del usuario
Los usuarios pueden utilizar los datos devueltos al analizar la respuesta JSON para extraer información relevante Por ejemplo pueden mostrar los nombres de los días festivos y las fechas en sus aplicaciones o usar datos de conversión lunar para información cultural o astrológica
La precisión de los datos se mantiene mediante actualizaciones regulares de fuentes fiables y la adhesión a las designaciones oficiales de días festivos El diseño de la API asegura que los usuarios reciban información consistente y precisa sobre los días festivos y fechas de Corea