API — табло відправлень

Інформація про найближчі відправлення з зупинки громадського транспорту (віртуальне табло).

• Endpoint: GET https://www.zditm.szczecin.pl/api/v1/displays/{stopNumber} (значення параметра {stopNumber} можна отримати через API для зупинок — поле number)
• Формат даних: application/json
• Частота оновлення: приблизно кожні 20 секунд

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

{
  "stop_name": "Brama Portowa",
  "stop_number": "10813",
  "departures": [
    {
      "line_number": "6",
      "direction": "Gocław",
      "time_real": 4,
      "time_scheduled": null
    },

    ...

  ],
  "message": null,
  "updated_at": "2023-06-02T20:18:08.522045Z"
}

• string stop_name — назва зупинки
• string stop_number — номер зупинки
• array departures — масив найближчих відправлень з цієї зупинки
  • string line_number — позначення маршруту (номер)
  • string direction — напрямок руху
  • int|null time_real — фактичний час до відправлення в хвилинах (якщо не null, то time_scheduled буде null)
  • string|null time_scheduled — запланований час відправлення у форматі hh:mm (якщо не null, то time_real буде null)
• string|null message — текстові повідомлення на табло
• 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.