API — каси з продажу квитків

Це документація для версії 2 API. Документація для застарілої версії 1.

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

  • Endpoint: GET https://www.zditm.szczecin.pl/api/v2/ticket-offices?format=json|cbor
  • Формат даних: application/json (за замовчуванням) або application/cbor (коли format=cbor)
  • Частота оновлення: за потребою

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

{
  "data": [
    {
      "id": 26,
      "name": "C.H. Turzyn",
      "type": {
        "symbol": "POK",
        "name": {
          "pl": "Punkt Obsługi Klientów",
          "en": "Passenger Service Point",
          "de": "Kundenberatungsstelle",
          "uk": "Пункт обслуговування клієнтів"
        }
      },
      "address": "najbliższe wejście od ul. 26 Kwietnia",
      "phone": "695690715",
      "note": null,
      "latitude": 53.427471,
      "longitude": 14.53099,
      "monday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "tuesday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "wednesday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "thursday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "friday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "saturday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "sunday": {
        "opening_hours": "10:00–16:00",
        "note": {
          "pl": "tylko niedziele handlowe",
          "en": "only on Sunday trading days",
          "de": "nur verkaufsoffene Sonntage",
          "uk": "тільки по робочих неділях"
        }
      },
      "updated_at": "2023-07-14T16:00:27.000000Z"
    },

    ...

  ]
}
  • int id — ідентифікатор каси продажу квитків
  • string name — назва каси продажу квитків
  • object type — об’єкт, що містить інформацію про тип каси продажу квитків
    • string symbol — символ типу каси продажу квитків
    • object name — об’єкт, що містить назву типу каси продажу квитків
      • string pl — назва типу каси продажу квитків польською мовою
      • string en — назва типу каси продажу квитків англійською мовою
      • string de — назва типу каси продажу квитків німецькою мовою
      • string uk — назва типу каси продажу квитків українською мовою
  • string|null address — адреса каси продажу квитків
  • string|null phone — номер телефону каси продажу квитків
  • object|null note — об’єкт, що містить додаткову інформацію (null, якщо всі підполя повертають null)
    • string|null pl — додаткова інформація польською мовою
    • string|null en — додаткова інформація англійською мовою
    • string|null de — додаткова інформація німецькою мовою
    • string|null uk — додаткова інформація українською мовою
  • float latitude — географічна широта каси продажу квитків
  • float longitude — географічна довгота каси продажу квитків
  • object monday, object tuesday, object wednesday, object thursday, object friday, object saturday, object sunday — об’єкти з інформацією про години роботи каси продажу квитків у кожен день тижня (понеділок, вівторок, середа, четвер, п’ятниця, субота, неділя)
    • string|null opening_hours — години роботи каси продажу квитків
    • object|null note — об’єкт, що містить додаткову інформацію (null, якщо всі підполя повертають null)
      • string|null pl — додаткова інформація польською мовою
      • string|null en — додаткова інформація англійською мовою
      • string|null de — додаткова інформація німецькою мовою
      • string|null 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.

Міграція з версії 1

  1. Endpoint змінено на: GET https://www.zditm.szczecin.pl/api/v2/ticket-offices.
  2. Поля type_symbol, type_name_pl, type_name_en, type_name_de і type_name_uk перенесено до нового об’єкта type.
  3. Поля notes_pl, notes_en, notes_de і notes_uk перенесено до нового об’єкта note.
  4. Поля notes_pl, notes_en, notes_de і notes_uk в об’єктах monday, tuesday, wednesday, thursday, friday, saturday і sunday перенесено до нового об’єкта note.
  5. Додатково підтримується формат CBOR (application/cbor) через параметр format=cbor.