API — описи змін у розкладі руху

Інформація про нещодавні та майбутні зміни в розкладах руху.

• Endpoint: GET https://www.zditm.szczecin.pl/api/v1/timetable-change-descriptions
• Формат даних: application/json
• Частота оновлення: за потребою

Структура даних

{
  "data": [
    {
      "id": 283,
      "valid_from": "2023-05-27T22:00:00.000000Z",
      "valid_to": null,
      "description": {
        "pl": "zmiana tras i rozkładów jazdy linii 806, 812, B, 522, 523, 525, 530, 532",
        "en": "change of the lines 806, 812, B, 522, 523, 525, 530, 532 routes and timetables",
        "de": "geänderte Strecken und Fahrpläne der Linien 806, 812, B, 522, 523, 525, 530, 532",
        "uk": "зміна схеми і розкладів руху маршрутів 806, 812, B, 522, 523, 525, 530, 532"
      },
      "updated_at": "2023-05-28T11:45:41.000000Z"
    },

    ...

  ]
}

• int id — ідентифікатор опису зміни
• string valid_from — дата й час початку дії змін
• string|null valid_to — дата й час закінчення дії змін (null, якщо кінцевий момент не визначено)
• object description — об’єкт із описами змін різними мовами
  • string pl — опис польською
  • string en — опис англійською
  • string de — опис німецькою
  • string uk — опис українською
• string updated_at — мітка часу останнього оновлення даних

Загальна інформація

1. Дані надаються безкоштовно за ліцензією CC0 1.0, для будь‑якого використання без попереднього погодження.
2. Zarząd Dróg i Transportu Miejskiego w Szczecinie (Управління доріг і міського транспорту в Щецині) не гарантує правильність чи повноту даних і не несе відповідальності за можливі збитки чи помилкові рішення на їх основі.
3. У продуктах (додатках, веб‑сайтах, публікаціях тощо) рекомендується вказувати джерело даних як «Zarząd Dróg i Transportu Miejskiego w Szczecinie» або скорочено «ZDiTM Szczecin» (не є обов’язковим).
4. За можливості бажано додати посилання на цю сторінку або на головну сторінку ZDiTM Szczecin (не є юридично обов’язковим).
5. Клієнти повинні розпізнавати й дотримуватися HTTP‑заголовки Cache-Control та ETag.
6. Кількість запитів до API обмежена: 100 запитів на хвилину з однієї IP‑адреси для всіх endpointів. Заголовок X-RateLimit-Remaining показує кількість залишкових запитів. Після вичерпання ліміту повертається код HTTP 429. У відповідному заголовку X-RateLimit-Reset вказано Unix‑мітку часу скидання ліміту, а Retry-After — кількість секунд до скидання.
7. Якщо можливо, додайте в заголовок User-Agent інформацію про організацію чи додаток, що використовує дані (наприклад, назву або URL).
8. У разі надмірного навантаження на сервер ZDiTM Szczecin залишає за собою право частково або повністю блокувати доступ до API.