iposho / holidays-calendar-ru

Производственный календарь РФ

Производственный календарь

API предоставляет производственные календари в формате JSON, актуальные для Российской Федерации. Доступные годы: с 2023 по 2024.

Ссылка на репозиторий: GitHub - holidays-calendar-ru

Содержание

• API Эндпоинты
  • Получить все доступные календари
  • Получить календарь на конкретный год
  • Получить праздничные и сокращенные дни на конкретный год
  • Получить календарь на конкретный месяц
  • Получить информацию о конкретном дне
• Локальная установка
• Как внести свой вклад
• Лицензия

API Эндпоинты

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

GET /api/calendar

curl -H "Content-Type:application/json" -X GET "https://calendar.kuzyak.in/api/calendar"

Ответ

{
  "years": [
    2023,
    2024
  ],
  "status": 200
}

Получить календарь на конкретный год

GET /api/calendar/:year

curl -H "Content-Type:application/json" -X GET "https://calendar.kuzyak.in/api/calendar/2023"

Ответ

{
  "year": 2023,
  "months": [
    {
      "id": 0,
      "name": "January",
      "workingDays": 17,
      "notWorkingDays": 14,
      "shortDays": 0,
      "workingHours": 136
    }
    // ... Другие месяцы
  ],
  "status": 200
}

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

GET /api/calendar/:year/holidays

curl -H "Content-Type:application/json" -X GET "https://calendar.kuzyak.in/api/calendar/2023/holidays"

Ответ

{
  "year": 2023,
  "holidays": [
    {
      "date": "2023-01-01T00:00:00.000Z",
      "name": "Новый год"
    }
    // ... Другие праздники
  ],
  "shortDays": [
    {
      "date": "2023-02-22T00:00:00.000Z",
      "name": "День защитника Отечества"
    }
    // ... Другие сокращенные дни
  ],
  "status": 200
}

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

GET /api/calendar/:year/:month

curl -H "Content-Type:application/json" -X GET "https://calendar.kuzyak.in/api/calendar/2023/1"

Ответ

{
  "year": 2023,
  "month": {
    "id": 0,
    "name": "January",
    "workingDays": 17,
    "notWorkingDays": 14,
    "shortDays": 0,
    "workingHours": 136
  },
  "status": 200
}

Получить информацию о конкретном дне

GET /api/calendar/:year/:month/:day

curl -H "Content-Type:application/json" -X GET "https://calendar.kuzyak.in/api/calendar/2023/2/22"

Ответ

{
  "year": 2023,
  "month": {
    "name": "February",
    "id": 1
  },
  "date": "2023-02-22T00:00:00.000Z",
  "isWorkingDay": true,
  "isShortday": true,
  "holiday": "День защитника Отечества",
  "status": 200
}

Локальная установка

git clone https://github.com/iposho/holidays-calendar-ru.git
cd holidays-calendar-ru/
npm i
[...]
npm run dev

Как внести свой вклад

1. Форкните этот репозиторий.
2. Создайте ветку своей фичи (git checkout -b my-new-feature).
3. Закоммитьте изменения (git commit -am 'Add some feature').
4. Запушьте изменения в репозиторий (git push origin my-new-feature).
5. Создайте новый пулл-реквест в ветку develop.

Лицензия

Это проект с открытым кодом, распространяющийся под лицензией MIT License.