← Volver al Panel

Documentación de la API

API pública para integrar cálculos de semanas epidemiológicas en sus aplicaciones.

URL Base

https://epiweek.com/api/v1

Todos los endpoints soportan CORS y devuelven respuestas JSON.

GET /api/v1/now

Obtener la semana epidemiológica actual.

Parámetros de Consulta

  • standard (opcional) - MMWR o ISO. Por defecto es MMWR
  • date (opcional) - Fecha en formato AAAA-MM-DD. Por defecto es hoy

Ejemplo de Solicitud

curl https://epiweek.com/api/v1/now?standard=MMWR

Ejemplo de Respuesta

{
  "week": 1,
  "year": 2026,
  "startDate": "2026-01-04T00:00:00.000Z",
  "endDate": "2026-01-10T00:00:00.000Z",
  "standard": "MMWR"
}

GET /api/v1/convert

Convertir una fecha específica a su semana epidemiológica.

Parámetros de Consulta

  • date (requerido) - Fecha en formato AAAA-MM-DD
  • standard (opcional) - MMWR o ISO. Por defecto es MMWR

Ejemplo de Solicitud

curl "https://epiweek.com/api/v1/convert?date=2025-12-25&standard=ISO"

Ejemplo de Respuesta

{
  "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]

Obtener todas las semanas epidemiológicas de un año específico.

Parámetros de Ruta

  • year (requerido) - Año entre 1900-2100

Parámetros de Consulta

  • standard (opcional) - MMWR o ISO. Por defecto es MMWR

Ejemplo de Solicitud

curl https://epiweek.com/api/v1/calendar/2026

Ejemplo de Respuesta

{
  "year": 2026,
  "standard": "MMWR",
  "totalWeeks": 52,
  "weeks": [
    {
      "week": 1,
      "year": 2026,
      "startDate": "2026-01-04",
      "endDate": "2026-01-10",
      "standard": "MMWR"
    }
  ]
}

Suscripción al Calendario

Suscríbase a las semanas epidemiológicas en su aplicación de calendario.

URL de Suscripción

https://epiweek.com/calendar.ics

Agregue esta URL a Google Calendar, Apple Calendar u Outlook para ver automáticamente las semanas epidemiológicas.

Descargar archivo .ics

Límite de Solicitudes

Las solicitudes de la API están limitadas a 100 solicitudes por minuto por dirección IP. Para límites más altos, contáctenos en [enable JavaScript].