API — маршрути

Інформація про маршрути громадського транспорту.

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

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

{
  "data": [
    {
      "id": 1,
      "number": "1",
      "type": "day",
      "subtype": "normal",
      "vehicle_type": "tram",
      "on_demand": false,
      "highlighted": false,
      "sort_order": 1,
      "updated_at": "2023-05-28T11:45:15.000000Z"
    },

    ...

  ]
}

int id — унікальний ідентифікатор маршруту (незмінний)
string number — позначення маршруту (номер) (може змінюватися)
string type — тип маршруту:
- day — денний маршрут
- night — нічний маршрут
string subtype — підтип маршруту:
- normal — звичайний маршрут
- semi-fast — напівшвидкісний маршрут
- fast — швидкісний маршрут
- replacement — заміщаючий маршрут
- additional — додатковий маршрут
- special — спеціальний маршрут
- tourist — туристичний маршрут
string vehicle_type — тип рухомого складу:
- skm — потяг SKM
- tram — трамвай
- bus — автобус
bool on_demand — true, якщо маршрут працює за системою «за викликом»
bool highlighted — true, якщо маршрут виділено помаранчевим кольором у пасажирських матеріалах (змінений маршрут або заміщаючий)
Додано 12 липня 2024 int sort_order — порядковий номер для впорядкованого відображення маршрутів (номери не обов’язково послідовні)
string updated_at — мітка часу останнього оновлення даних

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

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