API – Fahrkartenschalter

Informationen zu den Fahrkartenschaltern.

• Endpoint: GET https://rozklad.renegades.at/api/v2/ticket-offices?format=json|cbor
• Datenformat: application/json (Standard) oder application/cbor (wenn format=cbor)
• Aktualisierungs­frequenz: nach Bedarf

Datenstruktur

{
  "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 – eindeutige Kennung der Fahrkartenverkaufsstelle
• string name – Name der Fahrkartenverkaufsstelle
• object type – Objekt mit Informationen zum Typ der Fahrkartenverkaufsstelle
  • string symbol – Symbol des Typs der Fahrkartenverkaufsstelle
  • object name – Objekt mit der Bezeichnung des Typs der Fahrkartenverkaufsstelle
    • string pl – Bezeichnung des Typs der Fahrkartenverkaufsstelle auf Polnisch
    • string en – Bezeichnung des Typs der Fahrkartenverkaufsstelle auf Englisch
    • string de – Bezeichnung des Typs der Fahrkartenverkaufsstelle auf Deutsch
    • string uk – Bezeichnung des Typs der Fahrkartenverkaufsstelle auf Ukrainisch
• string|null address – Adresse der Fahrkartenverkaufsstelle
• string|null phone – Telefonnummer der Fahrkartenverkaufsstelle
• object|null note – Objekt mit zusätzlichen Informationen (null, wenn alle Unterfelder null zurückgeben)
  • string|null pl – zusätzliche Informationen auf Polnisch
  • string|null en – zusätzliche Informationen auf Englisch
  • string|null de – zusätzliche Informationen auf Deutsch
  • string|null uk – zusätzliche Informationen auf Ukrainisch
• float latitude – geografische Breite der Fahrkartenverkaufsstelle
• float longitude – geografische Länge der Fahrkartenverkaufsstelle
• object monday, object tuesday, object wednesday, object thursday, object friday, object saturday, object sunday – Objekte mit Informationen zu den Öffnungszeiten der Fahrkartenverkaufsstelle an den einzelnen Wochentagen (Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag)
  • string|null opening_hours – Öffnungszeiten der Fahrkartenverkaufsstelle
  • object|null note – Objekt mit zusätzlichen Informationen (null, wenn alle Unterfelder null zurückgeben)
    • string|null pl – zusätzliche Informationen auf Polnisch
    • string|null en – zusätzliche Informationen auf Englisch
    • string|null de – zusätzliche Informationen auf Deutsch
    • string|null uk – zusätzliche Informationen auf Ukrainisch
• string updated_at – Zeitstempel der letzten Datenaktualisierung

Allgemeine Informationen

1. Die Daten werden kostenfrei unter der CC0 1.0‑Lizenz bereitgestellt und dürfen ohne vorherige Anmeldung für beliebige Zwecke genutzt werden.
2. Der Zarząd Dróg i Transportu Miejskiego w Szczecinie (Straßen- und Stadtverkehrsverwaltung in Szczecin) übernimmt keine Gewähr für die Richtigkeit oder Vollständigkeit der Daten und haftet nicht für Schäden oder Fehlentscheidungen, die auf deren Basis getroffen werden.
3. In Produkten, die die Daten verwenden (App, Website, Publikation o. Ä.), bitten wir um die Angabe der Datenquelle „Zarząd Dróg i Transportu Miejskiego w Szczecinie“ oder abgekürzt „ZDiTM Szczecin“, dies ist jedoch nicht gesetzlich vorgeschrieben.
4. Ebenfalls optional, aber erwünscht: Ein Link zu dieser Webseite oder zur Hauptseite von ZDiTM Szczecin in Ihrem Produkt.
5. Clients sollten die HTTP‑Header Cache-Control und ETag erkennen und beachten.
6. Die Anzahl der API‑Anfragen ist begrenzt: Es sind 100 Anfragen pro Minute und IP‑Adresse über alle Endpunkte erlaubt. Der Header X-RateLimit-Remaining zeigt die verbleibenden Anfragen an. Nach Erreichen des Limits wird der HTTP‑Status 429 zurückgegeben. Der Header X-RateLimit-Reset enthält dann einen Unix‑Timestamp für die Rücksetzung des Limits, und der Header Retry-After gibt die verbleibenden Sekunden bis zur Rücksetzung an.
7. Wenn möglich, fügen Sie im User-Agent‑Header Ihrer Anfragen einen Hinweis auf den nutzenden Dienst (z. B. Name der App, Website oder URL) hinzu.
8. Bei übermäßiger Serverlast behält sich ZDiTM Szczecin das Recht vor, den API‑Zugang teilweise oder vollständig zu sperren.

Migration von Version 1

1. Endpoint geändert auf: GET https://rozklad.renegades.at/api/v2/ticket-offices.
2. Die Felder type_symbol, type_name_pl, type_name_en, type_name_de und type_name_uk wurden in das neue Objekt type verschoben.
3. Die Felder notes_pl, notes_en, notes_de und notes_uk wurden in das neue Objekt note verschoben.
4. Die Felder notes_pl, notes_en, notes_de und notes_uk in den Objekten monday, tuesday, wednesday, thursday, friday, saturday und sunday wurden in das neue Objekt note verschoben.
5. Zusätzlich wird das CBOR-Format (application/cbor) über den Parameter format=cbor unterstützt.