← Voltar ao Painel
Documentação da API
API pública para integrar cálculos de semanas epidemiológicas em suas aplicações.
URL Base
https://epiweek.com/api/v1 Todos os endpoints suportam CORS e retornam respostas JSON.
GET /api/v1/now
Obter a semana epidemiológica atual.
Parâmetros de Consulta
standard(opcional) - MMWR ou ISO. Padrão é MMWRdate(opcional) - Data no formato AAAA-MM-DD. Padrão é hoje
Exemplo de Requisição
curl https://epiweek.com/api/v1/now?standard=MMWRExemplo de Resposta
{
"week": 1,
"year": 2026,
"startDate": "2026-01-04T00:00:00.000Z",
"endDate": "2026-01-10T00:00:00.000Z",
"standard": "MMWR"
}GET /api/v1/convert
Converter uma data específica para sua semana epidemiológica.
Parâmetros de Consulta
date(obrigatório) - Data no formato AAAA-MM-DDstandard(opcional) - MMWR ou ISO. Padrão é MMWR
Exemplo de Requisição
curl "https://epiweek.com/api/v1/convert?date=2025-12-25&standard=ISO"Exemplo de Resposta
{
"week": 52,
"year": 2025,
"startDate": "2025-12-22T00:00:00.000Z",
"endDate": "2025-12-28T00:00:00.000Z",
"standard": "ISO"
}GET /api/v1/calendar/[year]
Obter todas as semanas epidemiológicas de um ano específico.
Parâmetros de Caminho
year(obrigatório) - Ano entre 1900-2100
Parâmetros de Consulta
standard(opcional) - MMWR ou ISO. Padrão é MMWR
Exemplo de Requisição
curl https://epiweek.com/api/v1/calendar/2026Exemplo de Resposta
{
"year": 2026,
"standard": "MMWR",
"totalWeeks": 52,
"weeks": [
{
"week": 1,
"year": 2026,
"startDate": "2026-01-04",
"endDate": "2026-01-10",
"standard": "MMWR"
}
]
}Assinatura do Calendário
Assine as semanas epidemiológicas no seu aplicativo de calendário.
URL de Assinatura
https://epiweek.com/calendar.ics Adicione esta URL ao Google Calendar, Apple Calendar ou Outlook para ver automaticamente as semanas epidemiológicas.
Baixar arquivo .icsLimite de Requisições
As requisições da API estão limitadas a 100 requisições por minuto por endereço IP. Para limites maiores, entre em contato conosco em [enable JavaScript].