← กลับไปที่แดชบอร์ด

เอกสาร 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 ถูกจำกัดที่ 100 คำขอต่อนาทีต่อที่อยู่ IP สำหรับขีดจำกัดที่สูงขึ้น โปรดติดต่อเราที่ [enable JavaScript].