← Retour au Tableau de Bord

Documentation de l'API

API publique pour intégrer les calculs de semaines épidémiologiques dans vos applications.

URL de Base

https://epiweek.com/api/v1

Tous les endpoints supportent CORS et retournent des réponses JSON.

GET /api/v1/now

Obtenir la semaine épidémiologique actuelle.

Paramètres de Requête

  • standard (optionnel) - MMWR ou ISO. Par défaut MMWR
  • date (optionnel) - Date au format AAAA-MM-JJ. Par défaut aujourd'hui

Exemple de Requête

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

Exemple de Réponse

{
  "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 une date spécifique en sa semaine épidémiologique.

Paramètres de Requête

  • date (obligatoire) - Date au format AAAA-MM-JJ
  • standard (optionnel) - MMWR ou ISO. Par défaut MMWR

Exemple de Requête

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

Exemple de Réponse

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

Obtenir toutes les semaines épidémiologiques d'une année spécifique.

Paramètres de Chemin

  • year (obligatoire) - Année entre 1900-2100

Paramètres de Requête

  • standard (optionnel) - MMWR ou ISO. Par défaut MMWR

Exemple de Requête

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

Exemple de Réponse

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

Abonnement au Calendrier

Abonnez-vous aux semaines épidémiologiques dans votre application de calendrier.

URL d'Abonnement

https://epiweek.com/calendar.ics

Ajoutez cette URL à Google Calendar, Apple Calendar ou Outlook pour voir automatiquement les semaines épidémiologiques.

Télécharger le fichier .ics

Limitation de Requêtes

Les requêtes API sont limitées à 100 requêtes par minute par adresse IP. Pour des limites plus élevées, veuillez nous contacter à [enable JavaScript].