← Tillbaka till Översikten

API-dokumentation

Publikt API för att integrera beräkningar av epidemiologiska veckor i dina applikationer.

Bas-URL

https://epiweek.com/api/v1

Alla endpoints stöder CORS och returnerar JSON-svar.

GET /api/v1/now

Hämta aktuell epidemiologisk vecka.

Frågeparametrar

  • standard (valfritt) - MMWR eller ISO. Standard är MMWR
  • date (valfritt) - Datum i ÅÅÅÅ-MM-DD-format. Standard är idag

Exempelförfrågan

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

Exempelsvar

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

GET /api/v1/convert

Konvertera ett specifikt datum till dess epidemiologiska vecka.

Frågeparametrar

  • date (obligatoriskt) - Datum i ÅÅÅÅ-MM-DD-format
  • standard (valfritt) - MMWR eller ISO. Standard är MMWR

Exempelförfrågan

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

Exempelsvar

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

Hämta alla epidemiologiska veckor för ett specifikt år.

Sökvägsparametrar

  • year (obligatoriskt) - År mellan 1900-2100

Frågeparametrar

  • standard (valfritt) - MMWR eller ISO. Standard är MMWR

Exempelförfrågan

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

Exempelsvar

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

Kalenderprenumeration

Prenumerera på epidemiologiska veckor i din kalenderapp.

Prenumerations-URL

https://epiweek.com/calendar.ics

Lägg till denna URL i Google Kalender, Apple Kalender eller Outlook för att automatiskt se epidemiologiska veckor.

Ladda ner .ics-fil

Hastighetsbegränsning

API-förfrågningar är begränsade till 100 förfrågningar per minut per IP-adress. För högre gränser, kontakta oss på [enable JavaScript].