isDayOff()

API производственного календаря

Проверка даты на принадлежность к нерабочему дню, согласно официальным указам и распоряжениям

Список поддерживаемых стран:

  • Белоруссия
  • Казахстан
  • Россия (по-умолчанию)
  • Украина

Описание запросов и ответов

Получение результата по полной дате

https://isdayoff.ru/YYYYMMDD

YYYY - год (20xx)

ММ - месяц (с лидирующим 0, например 02)

DD - день (с лидирующим 0, например 07)

Возможные результаты

Ответ сервиса Значение Код возврата HTTP
0 Рабочий день 200
1 Нерабочий день 200
100 Ошибка в дате 400
101 Данные не найдены 404

Получение результата по полной дате с указанием страны

https://isdayoff.ru/YYYYMMDD?cc=CC

CC - код страны из списка

Код стран

Коды стран Страна
by Белоруссия
kz Казахстан
ru Россия
ua Украина

Возможные результаты

Ответ сервиса Значение Код возврата HTTP
0 Рабочий день 200
1 Нерабочий день 200
100 Ошибка в дате/коде страны 400
101 Данные не найдены 404

Получение результата по полной дате с указанием страны

https://isdayoff.ru/YYYYMMDD?pre=[0|1]

pre – Распознавать, что день предпразнечный:

      0 - Без вывода сокращённых дней (по-умолчанию)
      1 - Распознавать, что день предпразнечный (сокращённый)

Возможные результаты

Ответ сервиса Значение Код возврата HTTP
0 Рабочий день 200
1 Нерабочий день 200
2 Сокращённый день 200
100 Ошибка в дате/коде страны 400
101 Данные не найдены 404

Заметка

Все параметры можно комбинировать друг с другом

Полный список доступных годов и стран

https://isdayoff.ru/db

Немного о проекте

Изначальная идея заключалась в получении средства, которое позволило бы запускать задачи cron только в выходные и праздничные дни, но ввиду интереса коллег, решил выложить для общего пользования

TODO

  • Добавление праздников Белоруссии, Украины, Казахстана и других ex-USSR
  • Возможность запроса бOльшего количества информации (неделя, месяц)
  • Вывод, если день является предпраздничным
  • Возможность работы с альясами дня (/0 - сегодня, /1 - завтра и т.д.)

Контакты

Основной разработчик: andrey@esin.name / telegram

(очень приветствуется помощь в добавлении новых стран)