A API de Feriados Públicos da Coreia oferece dados oficiais de feriados públicos para a Coreia do Sul de 2024 a 2027, obtidos diretamente do governo coreano através do data.go.kr (Instituto Coreano de Astronomia e Ciências Espaciais).
Principais Recursos:
Pontos de Extremidade:
Retorna todos os feriados públicos oficiais da Coreia do Sul para um determinado ano (2024-2027), incluindo feriados substitutos
{"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/12498/comprehensive+korea+public+holidays+api/23787/get+korean+public+holidays+by+year&YEAR=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Obtenha todos os feriados públicos oficiais da Coreia para um mês e ano específicos. Retorna um objeto JSON com ano, mês, contagem e um array de objetos de feriado. Cada feriado inclui a data (formato AAAAMMDD), campos individuais de ano/mês/dia, nome em inglês, nome em coreano (name_ko) e um indicador is_holiday. Útil para aplicações de calendário mensal, sistemas de folha de pagamento e plataformas de RH. Dados obtidos de data.go.kr. Anos suportados: 2024-2027.
{"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/12498/comprehensive+korea+public+holidays+api/23788/get+korean+holidays+by+month&YEAR=Required&/=Required&MONTH=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Verifique rapidamente se uma data específica é um feriado público da Coreia. Passe a data no formato AAAA-MM-DD. Retorna um objeto JSON indicando se a data é um feriado, junto com o nome do feriado (em inglês e coreano) quando aplicável. Útil para lógica de negócios, agendamentos, cálculos de licença/PTO e qualquer aplicativo que precise saber se um determinado dia é um dia útil na Coreia do Sul. Dados provenientes de data.go.kr. Intervalo de datas suportado: 2024-01-01 a 2027-12-31.
{"date":"20260101","is_holiday":true,"name":"New Year's Day"}
curl --location --request GET 'https://zylalabs.com/api/12498/comprehensive+korea+public+holidays+api/23789/check+if+date+is+korean+holiday&DATE=Required' --header 'Authorization: Bearer YOUR_API_KEY'
| 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. O teste gratuito inclui até 50 requisições.
Cada endpoint retorna dados sobre feriados públicos da Coreia do Sul, incluindo nomes de feriados, datas e se são feriados substitutos. Por exemplo, o endpoint GET /holidays/{year} fornece uma lista completa de feriados para o ano especificado
Os campos principais na resposta incluem "data" (formato AAAAMMDD), "ano", "mês", "dia", "nome" (inglês), "nome_ko" (coreano) e "é_feriado" (booleano indicando se é um feriado)
Os dados de resposta estão estruturados como um objeto JSON contendo o ano, a contagem de feriados e um array de objetos de feriado. Cada objeto de feriado inclui detalhes específicos como data, nome e se é um feriado substituto
A API fornece informações sobre feriados públicos, incluindo feriados regulares e feriados substitutos, para os anos de 2024 a 2027. Os usuários podem consultar por ano, mês ou verificar datas específicas
Os endpoints aceitam parâmetros como "ano" (para GET /holidays/{year}), "mês" (para GET /holidays/{year}/{month}), e "data" (para GET /holidays/check/{date}). Os usuários podem personalizar solicitações com base nesses parâmetros
Os dados são obtidos do governo coreano por meio do data.go.kr garantindo que sejam oficiais e confiáveis Isso aumenta a precisão e a credibilidade das informações sobre feriados fornecidas
Casos de uso típicos incluem planejamento de eventos, agendamento de trabalho e compreensão dos impactos dos feriados nas operações comerciais na Coreia do Sul. Os desenvolvedores podem integrar esses dados em aplicativos para a conscientização dos usuários sobre os feriados
Os usuários podem utilizar os dados retornados fazendo a análise da resposta JSON para extrair informações relevantes sobre as férias como exibir as próximas férias em aplicativos ou verificar se datas específicas são feriados para fins de agendamento
Use o endpoint GET /holidays/check/{date}, substituindo {date} pela data desejada no formato AAAAMMDD. A resposta indicará se a data é um feriado e fornecerá o nome do feriado, se aplicável
A API Abrangente de Feriados Públicos da Coreia cobre feriados públicos de 2024 a 2027 Você pode consultar feriados para qualquer um desses anos usando o endpoint apropriado
Sim, você pode usar o endpoint GET /holidays/{year}/{month} para recuperar feriados para um mês específico dentro dos anos 2024-2027 Substitua {year} e {month} pelos valores desejados
O campo "is_holiday" é um valor booleano que indica se a data é um feriado. Se verdadeiro, a data é reconhecida como um feriado; se falso, não é
Feriados substitutos estão incluídos na lista de feriados com o campo "name" indicando o nome do feriado e o campo "name_ko" mostrando o nome em coreano O campo "is_holiday" também será verdadeiro para essas datas
Se a API retornar um array vazio para um mês específico, isso significa que não há feriados públicos para esse mês. Você pode lidar com esse cenário em seu aplicativo exibindo uma mensagem indicando que não há feriados disponíveis
A API retorna os nomes dos feriados em inglês através do campo "name" na resposta. Certifique-se de analisar este campo para exibir os nomes dos feriados corretamente em sua aplicação
A API retorna dados no formato JSON Cada resposta inclui um objeto estruturado com campos como "ano", "contagem" e um array de objetos de feriado facilitando a análise e utilização em aplicações
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
264ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
157ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
451ms
Nível de serviço:
100%
Tempo de resposta:
1.856ms
Nível de serviço:
75%
Tempo de resposta:
281ms
Nível de serviço:
100%
Tempo de resposta:
604ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
264ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
157ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
451ms
Nível de serviço:
100%
Tempo de resposta:
1.856ms
Nível de serviço:
100%
Tempo de resposta:
1.366ms
Nível de serviço:
100%
Tempo de resposta:
76ms