Feriados públicos coreanos com lógica de feriado substituto, além de romanização revisada precisa do texto coreano - em uma API JSON rápida, sem dependências, em uma borda global. Verifique se alguma data é um feriado público, liste os feriados de um ano, romanize o Hangul ou obtenha a data e o status do feriado da Coreia de hoje. Conversão lunar-solar, os 24 termos solares e o ciclo sexagenário chegando na 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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Calendário da Coreia API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
(Economize 2 meses com cobrança anual 🎉)
A API do Calendário da Coreia fornece dados precisos do calendário coreano e romanização coreana através de uma API rápida, em JSON e sem dependências que opera em uma edge global.
AO VIVO AGORA
PONTOS DE ACESSO
GET /v1/holidays?year=2026
GET /v1/holidays/is?date=2026-09-25
GET /v1/romanize?text=SUA_TEXT
GET /v1/today
CHEGANDO NA v1.1
Conversão lunar-solar, os 24 termos solares e o ciclo sexagenário - dados que APIs globais de feriados não fornecem.
PARA QUEM É
Aplicativos voltados para a Coreia, produtos da K-cultura e K-pop, ferramentas de agendamento e RH, e aplicativos de calendário ou astrologia que precisam de feriados coreanos corretos e romanização limpa.
As datas dos feriados são feriados legais na Coreia do Sul (fonte: dados de feriados públicos da KASI via data.go.kr).
Cada ponto de extremidade retorna dados específicos relacionados a feriados públicos coreanos, romanização do Hangul e conversões de data. Por exemplo, o ponto de extremidade de feriados fornece uma lista de feriados para um determinado ano, enquanto o ponto de extremidade de romanização converte texto em Hangul para Romanização Revisada
Os campos principais incluem "data", "nome" (coreano), "nome_en" (inglês), "substituto" (booleano) e para conversões lunares, "ano_lunar", "mês_lunar" e "dia_lunar" Esses campos fornecem informações essenciais sobre feriados e conversões de data
Os pontos finais aceitam parâmetros como "ano" para o ponto final de feriados "data" para verificar se uma data é um feriado ou para conversões lunares e "texto" para romanização Os usuários podem personalizar as solicitações especificando esses parâmetros
Os dados de resposta estão estruturados no formato JSON Por exemplo o endpoint de feriados retorna um objeto contendo o ano a contagem de feriados e um array de objetos de feriados cada um com campos relevantes como data e nomes em ambas as línguas
Os dados são provenientes das informações de feriados públicos do KASI via data.go.kr garantindo que as informações sobre os feriados sejam precisas e atualizadas Esta fonte confiável contribui para a qualidade dos dados da API
Casos de uso típicos incluem a integração de informações sobre feriados coreanos em aplicativos, ferramentas de agendamento e sistemas de RH. Os desenvolvedores também podem usar o recurso de romanização para aplicativos de aprendizado de idiomas ou plataformas de cultura K para melhorar a experiência do usuário
Os usuários podem utilizar os dados retornados analisando a resposta JSON para extrair informações relevantes Por exemplo eles podem exibir nomes e datas de feriados em suas aplicações ou usar dados de conversão lunar para insights culturais ou astrológicos
A precisão dos dados é mantida por meio de atualizações regulares de fontes confiáveis e adesão às designações oficiais de feriados O design da API garante que os usuários recebam informações consistentes e precisas sobre feriados e datas coreanas