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
- string|null
message
— текстові повідомлення на табло - 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
показує кількість залишкових запитів. Після вичерпання ліміту повертається код HTTP429
. У відповідному заголовкуX-RateLimit-Reset
вказано Unix‑мітку часу скидання ліміту, аRetry-After
— кількість секунд до скидання. - Якщо можливо, додайте в заголовок
User-Agent
інформацію про організацію чи додаток, що використовує дані (наприклад, назву або URL). - У разі надмірного навантаження на сервер ZDiTM Szczecin залишає за собою право частково або повністю блокувати доступ до API.