← Вернуться на панель

Документация API

Публичный API для интеграции расчётов эпидемиологических недель в ваши приложения.

Базовый URL

https://epiweek.com/api/v1

Все конечные точки поддерживают CORS и возвращают JSON-ответы.

GET /api/v1/now

Получить текущую эпидемиологическую неделю.

Параметры запроса

  • standard (необязательно) - MMWR или ISO. По умолчанию MMWR
  • date (необязательно) - Дата в формате ГГГГ-ММ-ДД. По умолчанию сегодня

Пример запроса

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 (обязательно) - Дата в формате ГГГГ-ММ-ДД
  • 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 Календарь, Apple Календарь или Outlook для автоматического отображения эпидемиологических недель.

Скачать файл .ics

Ограничение запросов

Количество API-запросов ограничено до 100 запросов в минуту на IP-адрес. Для увеличения лимитов свяжитесь с нами: [enable JavaScript].