API — стаціонарні квиткомати

Інформація про стаціонарні квиткомати.

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

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

{
  "data": [
    {
      "id": 1,
      "location": "aleja Powstańców Wielkopolskich",
      "latitude": 53.406796,
      "longitude": 14.528817,
      "updated_at": "2023-05-19T19:38:56.000000Z"
    },

    ...

  ]
}
  • int id — ідентифікатор квиткомата
  • string location — опис місцезнаходження квиткомата
  • float latitude — географічна широта квиткомата
  • float longitude — географічна довгота квиткомата
  • 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.