← Kembali ke Papan Pemuka

Dokumentasi API

API awam untuk mengintegrasikan pengiraan minggu epidemiologi ke dalam aplikasi anda.

URL Asas

https://epiweek.com/api/v1

Semua titik akhir menyokong CORS dan mengembalikan respons JSON.

GET /api/v1/now

Dapatkan minggu epidemiologi semasa.

Parameter Pertanyaan

  • standard (pilihan) - MMWR atau ISO. Lalai ialah MMWR
  • date (pilihan) - Tarikh dalam format YYYY-MM-DD. Lalai ialah 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

Tukar tarikh tertentu kepada minggu epidemiologinya.

Parameter Pertanyaan

  • date (diperlukan) - Tarikh dalam format YYYY-MM-DD
  • standard (pilihan) - MMWR atau ISO. Lalai ialah 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 Laluan

  • year (diperlukan) - Tahun antara 1900-2100

Parameter Pertanyaan

  • standard (pilihan) - MMWR atau ISO. Lalai ialah 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 Kalendar

Langgan minggu epidemiologi dalam aplikasi kalendar anda.

URL Langganan

https://epiweek.com/calendar.ics

Tambah URL ini ke Google Calendar, Apple Calendar, atau Outlook untuk melihat minggu epidemiologi secara automatik.

Muat Turun Fail .ics

Had Kadar

Permintaan API dihadkan kepada 100 permintaan seminit bagi setiap alamat IP. Untuk had yang lebih tinggi, sila hubungi kami di [enable JavaScript].