← ڈیش بورڈ پر واپس جائیں

API دستاویزات

اپنی ایپلیکیشنز میں وبائی ہفتہ کے حسابات کو ضم کرنے کے لیے عوامی API۔

بنیادی URL

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

کیلنڈر سبسکرپشن

اپنی کیلنڈر ایپ میں وبائی ہفتوں کو سبسکرائب کریں۔

سبسکرپشن URL

https://epiweek.com/calendar.ics

وبائی ہفتوں کو خودکار طور پر دیکھنے کے لیے یہ URL Google Calendar، Apple Calendar، یا Outlook میں شامل کریں۔

.ics فائل ڈاؤن لوڈ کریں

ریٹ کی حد بندی

API درخواستیں فی IP پتہ فی منٹ 100 درخواستوں تک محدود ہیں۔ زیادہ حدود کے لیے، براہ کرم ہم سے رابطہ کریں [enable JavaScript].