← Rudi kwenye Dashibodi

Nyaraka za API

API ya umma ya kuunganisha hesabu za wiki za epidemiolojia katika programu zako.

URL ya Msingi

https://epiweek.com/api/v1

Vituo vyote vinaunga mkono CORS na kurudisha majibu ya JSON.

GET /api/v1/now

Pata wiki ya sasa ya epidemiolojia.

Vigezo vya Hoja

  • standard (hiari) - MMWR au ISO. Chaguo-msingi ni MMWR
  • date (hiari) - Tarehe katika muundo wa YYYY-MM-DD. Chaguo-msingi ni leo

Mfano wa Ombi

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

Mfano wa Jibu

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

GET /api/v1/convert

Badilisha tarehe mahususi kuwa wiki yake ya epidemiolojia.

Vigezo vya Hoja

  • date (inahitajika) - Tarehe katika muundo wa YYYY-MM-DD
  • standard (hiari) - MMWR au ISO. Chaguo-msingi ni MMWR

Mfano wa Ombi

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

Mfano wa Jibu

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

Pata wiki zote za epidemiolojia kwa mwaka mahususi.

Vigezo vya Njia

  • year (inahitajika) - Mwaka kati ya 1900-2100

Vigezo vya Hoja

  • standard (hiari) - MMWR au ISO. Chaguo-msingi ni MMWR

Mfano wa Ombi

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

Mfano wa Jibu

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

Usajili wa Kalenda

Jisajili kwa wiki za epidemiolojia katika programu yako ya kalenda.

URL ya Usajili

https://epiweek.com/calendar.ics

Ongeza URL hii kwenye Google Calendar, Apple Calendar, au Outlook ili kuona wiki za epidemiolojia kiotomatiki.

Pakua Faili ya .ics

Kikomo cha Kasi

Maombi ya API yamewekewa kikomo cha maombi 100 kwa dakika kwa kila anwani ya IP. Kwa vikomo vya juu zaidi, tafadhali wasiliana nasi kupitia [enable JavaScript].