Версия v2 предназначена для плавной миграции со старого API. Главное отличие: API-ключ передаётся в заголовке, а не в query string.
v2 — основная и актуальная версия API для новых интеграций.
/api/v2/...
Путь /api/ редиректит на эту страницу. Лимиты запросов, месячная квота и максимальный диапазон периода зависят от тарифа пользователя.
Используйте один из заголовков:
Authorization: Bearer API_KEY
X-API-Key: API_KEY
Параметр ?key= в v2 не поддерживается.
/api/v2/day
/api/v2/day?date=2026-02-09
Параметры:
/api/v2/month
/api/v2/month?month=2&year=2026
/api/v2/month?month=February&year=2026
Параметры:
/api/v2/year
/api/v2/year?year=2026
Параметры:
/api/v2/period?start=2026-02-01&end=2026-02-28
Параметры:
В v2 период строго валидируется: только ISO-формат, дата начала не может быть позже даты окончания, а максимальная длина диапазона зависит от тарифа пользователя.
| Код | Описание |
|---|---|
| 0 | Рабочий день |
| 1 | Нерабочий день |
| 2 | Сокращённый день |
| 5 | Первый рабочий день после выходных |
| 8 | Праздничный день |
| HTTP код | Описание |
|---|---|
| 403 | Доступ запрещён |
| 400 | Ошибка в параметрах запроса или формате даты |
| 429 | Превышен лимит скорости, месячная квота или лимит диапазона по тарифу |
| 404 | Данные не найдены |