Рабочие дни - документация API

Общая информация

API предоставляет информацию о рабочих и нерабочих днях в России, включая:

• Праздничные дни (Новогодние праздники, День Победы и т.д.)
• Рабочие выходные (переносы выходных дней)
• Расчет количества календарных и рабочих дней между датами

Аутентификация

Все запросы требуют токен авторизации:

• Header: X-API-Token: your-token
• Параметр: ?token=your-token

Эндпоинты API

1. Получение всех специальных дней

GET /api/public/workdays

Возвращает все специальные дни (праздники и рабочие выходные).

2. Получение дней за год

GET /api/public/workdays?year=2024

Возвращает специальные дни за указанный год.

3. Проверка конкретной даты

GET /api/public/workdays/date?date=2024-01-01

Проверяет, является ли указанная дата рабочим днем.

4. Расчет дней между датами

GET /api/public/workdays/calculate?start_date=2024-01-01&end_date=2024-01-10

Рассчитывает количество календарных и рабочих дней между датами.

5. Получение дней за период

GET /api/public/workdays/period?start_date=2024-01-01&end_date=2024-12-31

Возвращает специальные дни за указанный период.

Примеры ответов

Проверка даты:

{
  "success": true,
  "data": {
    "date": "2024-01-01",
    "is_working": false,
    "day_of_week": "Monday",
    "special_info": {
      "is_working": false,
      "description": "Новогодние праздники"
    },
    "next_working_day": "2024-01-09"
  }
}

Расчет дней:

{
  "success": true,
  "data": {
    "start_date": "2024-01-01",
    "end_date": "2024-01-10",
    "calendar_days": 9,
    "working_days": 2,
    "start_date_info": {
      "is_working": false,
      "special_info": {"description": "Новогодние праздники"}
    },
    "end_date_info": {
      "is_working": true
    }
  }
}