← العودة إلى لوحة التحكم

توثيق API

واجهة برمجة تطبيقات عامة لدمج حسابات الأسابيع الوبائية في تطبيقاتك.

الرابط الأساسي

https://epiweek.com/api/v1

جميع نقاط النهاية تدعم CORS وتُرجع استجابات JSON.

GET /api/v1/now

احصل على الأسبوع الوبائي الحالي.

معاملات الاستعلام

  • standard (اختياري) - MMWR أو ISO. الافتراضي هو MMWR
  • date (اختياري) - التاريخ بتنسيق YYYY-MM-DD. الافتراضي هو اليوم

مثال على الطلب

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

مثال على الاستجابة

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

GET /api/v1/convert

حوّل تاريخًا محددًا إلى أسبوعه الوبائي.

معاملات الاستعلام

  • date (مطلوب) - التاريخ بتنسيق YYYY-MM-DD
  • standard (اختياري) - MMWR أو ISO. الافتراضي هو MMWR

مثال على الطلب

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

مثال على الاستجابة

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

احصل على جميع الأسابيع الوبائية لسنة محددة.

معاملات المسار

  • year (مطلوب) - سنة بين 1900-2100

معاملات الاستعلام

  • standard (اختياري) - MMWR أو ISO. الافتراضي هو MMWR

مثال على الطلب

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

مثال على الاستجابة

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

الاشتراك في التقويم

اشترك في الأسابيع الوبائية في تطبيق التقويم الخاص بك.

رابط الاشتراك

https://epiweek.com/calendar.ics

أضف هذا الرابط إلى Google Calendar أو Apple Calendar أو Outlook لرؤية الأسابيع الوبائية تلقائيًا.

تنزيل ملف .ics

تحديد المعدل

طلبات API محدودة بـ 100 طلب في الدقيقة لكل عنوان IP. للحصول على حدود أعلى، يرجى التواصل معنا على [enable JavaScript].