Календар свят — API робочих днів Online
Арифметика робочих днів для однієї країни, за потреби одного регіону: підрахунок робочих днів між двома датами, додавання або віднімання робочих днів, перевірка дати, пошук наступного / попереднього робочого дня. Враховує вихідні країни, загальнонаціональні та регіональні святкові вихідні, перенесення днів за постановою (робоча субота) і правило воєнного стану в Україні. Дати від 2020-01-01 до 2035-12-31. Відповідь з попередньо обчисленого календаря за кілька мілісекунд.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/business-days
— клас квоти: cheap
| Параметр | Опис |
|---|---|
op | count (за замовчуванням) | add | subtract | is | next | prev |
country | Код країни ISO-2 (обов'язково, одна) |
region | Регіон ISO 3166-2, напр. DE-BY (необов'язково) |
start_date | YYYY-MM-DD (обов'язково) |
end_date | YYYY-MM-DD (op=count) |
days | Робочі дні для додавання або віднімання, 0-3650 (op=add|subtract); 0 = start_date, якщо це робочий день, інакше наступний (add) або попередній (subtract) робочий день |
inclusive | op=count: true (за замовчуванням) враховує start_date і end_date; false виключає start_date |
weekend | Необов'язкове перевизначення вихідних, напр. fri,sat або 5,6 (дні тижня ISO); none = без вихідних днів |
Поля відповіді — усередині об’єкта data у конверті відповіді. [] позначає список, тож data.items[].name — це поле name кожного елемента. Поле буває null, відсутнє або порожній список, коли значення в нас немає, — заглушок ми не підставляємо.
| Поле | Опис |
|---|---|
data.business_days | op=count: робочі дні в діапазоні, з calendar_days і non_business_days. |
data.result_date | op=add|subtract|next|prev: отримана дата. |
data.is_business_day | op=is: true або false, з reasons[] (weekend, holiday: <name>, day off by decree transfer), якщо false. |
data.weekend_days | Присутнє, якщо ?weekend= перевизначив вихідні країни. |
data.calendar_window | Перша й остання дати, які охоплює календар. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/business-days?op=count&country=DE®ion=DE-BY&start_date=2026-01-01&end_date=2026-12-31" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Оновлено