Kembali ke Dasbor

Dokumentasi API

API publik untuk mengintegrasikan perhitungan minggu epidemiologi ke dalam aplikasi Anda.

URL Dasar

https://epiweek.com/api/v1

Semua endpoint mendukung CORS dan mengembalikan respons JSON.

GET /api/v1/now

Dapatkan minggu epidemiologi saat ini.

Parameter Kueri

  • standard (opsional) - MMWR atau ISO. Bawaan adalah MMWR
  • date (opsional) - Tanggal dalam format YYYY-MM-DD. Bawaan adalah hari ini

Contoh Permintaan

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

Contoh Respons

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

GET /api/v1/convert

Konversikan tanggal tertentu ke minggu epidemiologinya.

Parameter Kueri

  • date (wajib) - Tanggal dalam format YYYY-MM-DD
  • standard (opsional) - MMWR atau ISO. Bawaan adalah MMWR

Contoh Permintaan

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

Contoh Respons

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

Dapatkan semua minggu epidemiologi untuk tahun tertentu.

Parameter Jalur

  • year (wajib) - Tahun antara 1900-2100

Parameter Kueri

  • standard (opsional) - MMWR atau ISO. Bawaan adalah MMWR

Contoh Permintaan

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

Contoh Respons

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

Langganan Kalender

Berlangganan minggu epidemiologi di aplikasi kalender Anda.

URL Langganan

https://epiweek.com/calendar.ics

Tambahkan URL ini ke Google Calendar, Apple Calendar, atau Outlook untuk melihat minggu epidemiologi secara otomatis.

Unduh Berkas .ics

Pembatasan Laju

Permintaan API dibatasi hingga 100 permintaan per menit per alamat IP. Untuk batas yang lebih tinggi, silakan hubungi kami di [enable JavaScript].