Документация
Простые запросы
Получение данных по дате
https://isdayoff.ru/YYYYMMDDhttps://isdayoff.ru/YYYY-MM-DDhttps://isdayoff.ru/YYMMDDhttps://isdayoff.ru/YY-MM-DDYYYY - год или YY - год (с лидирующим 0, например 09)
ММ - месяц (с лидирующим 0, например 02)
DD - день (с лидирующим 0, например 07)
Получение данных с помощью альясов
https://isdayoff.ru/todayстатус сегодняшнего дня
https://isdayoff.ru/tomorrowстатус завтрашнего дня
Часовой пояс будет определён на основе IP-адреса с которого происходит запрос
Если же такого не произошло, то необходимо уточнить с помощью параметра tz. Названия часовых поясов можно взять из базы данных IANA
Например, для часового пояса, в котором находится Москва (GMT+3): https://isdayoff.ru/today?tz=Europe/Moscow
Для проверки
https://isdayoff.ru/nowвывод даты, времени и смещение в минутах
Поможет узнать правильно ли определён часовой пояс
Параметризованные запросы
Указание страны
https://isdayoff.ru/YYYYMMDD?cc=CCcc - двухбуквенный код страны (формат ISO 3166-1 alpha-2)
Учёт сокращённых дней
https://isdayoff.ru/YYYYMMDD?pre=[0|1]pre - параметр, для учёта сокращённых дней
Значение параметра pre | Назначение |
|---|---|
0 | Без учёта сокращённых дней (по-умолчанию) |
1 | Учёт сокращённых дней. Помечать кодом 2 |
Учёт шестидневной рабочей недели
https://isdayoff.ru/YYYYMMDD?sd=[0|1]sd - параметр, для учёта шестидневной рабочей недели
Значение параметра sd | Назначение |
|---|---|
0 | Пятидневная рабочая неделя (по-умолчанию) |
1 | Шестидневная рабочая неделя |
Учёт нерабочих дней во время пандемии COVID-19
https://isdayoff.ru/YYYYMMDD?covid=[0|1]covid - параметр, для учёта нерабочих дней во время пандемии COVID-19
Значение параметра covid | Назначение |
|---|---|
0 | Не учитывать специальные указы (по-умолчанию) |
1 | Учитывать специальные указы и помечать кодом 4 |
Проверять, является ли день праздничным
https://isdayoff.ru/YYYYMMDD?holiday=[0|1]holiday - параметр, для учёта нерабочих дней во время пандемии COVID-19
Значение параметра holiday | Назначение |
|---|---|
0 | Не выделять, что день праздничный (по-умолчанию) |
1 | Выделять праздничные дни кодом 8 |
Расширенные запросы
Получение данных на дату
https://isdayoff.ru/api/getdata?year=YYYY&month=MM&day=DDyear - год в формате YYYY
month - месяц в формате MM
day - день в формате DD
Получение данных за месяц
https://isdayoff.ru/api/getdata?year=YYYY&month=MMyear - год в формате YYYY
month - месяц в формате MM
Получение данных за год
https://isdayoff.ru/api/getdata?year=YYYYyear - год в формате YYYY
Получение данных за произвольный период
Возможно запросить не более 366 дней
https://isdayoff.ru/api/getdata?date1=YYYYMMDD&date2=YYYYMMDDdate1, date2 - даты в формате YYYYMMDD, где
YYYY - год
ММ - месяц
DD - день
Полный список параметров
pre - параметр, для учёта сокращённых дней
delimeter - разделитель дней при выводе (не более 7 символов). Для вывода дней построчно, необходимо указать %0A (по-умолчанию - пусто)
covid - параметр, для учёта нерабочих дней во время пандемии COVID-19
sd - параметр, для учёта шестидневной рабочей недели
Ответы сервиса
| Ответ сервиса | Значение | Код ответа HTTP |
|---|---|---|
0 | Рабочий день | 200 |
1 | Нерабочий день | 200 |
2 | Сокращённый день | 200 |
4 | Рабочий день * | 200 |
8 | Праздничный день * | 200 |
100 | Ошибка в дате/коде страны | 400 |
101 | Данные не найдены | 404 |
199 | Ошибка сервиса | 400 |
Проверка года на високосность
https://isdayoff.ru/api/isleap?year=YYYYYYYY - год
| Ответ сервиса | Значение | Код ответа HTTP |
|---|---|---|
0 | Невисокосный год | 200 |
1 | Високосный год | 200 |
100 | Ошибка в годе | 400 |
101 | Данные не найдены | 404 |
199 | Ошибка сервиса | 400 |