API – Fahrkartenschalter (Version 1)

Informationen zu den Fahrkartenschaltern.

• Endpoint: GET https://www.zditm.szczecin.pl/api/v1/ticket-offices
• Datenformat: application/json
• Aktualisierungs­frequenz: nach Bedarf

Datenstruktur

{
  "data": [
    {
      "id": 1,
      "name": "Basen Górniczy",
      "type_symbol": "POK",
      "type_name_pl": "Punkt Obsługi Klientów",
      "type_name_en": "Passenger Service Point",
      "type_name_de": "Kundenberatungsstelle",
      "type_name_uk": "Пункт обслуговування клієнтів",
      "address": "pętla – ul. Gdańska 25",
      "phone": "695690142",
      "notes_pl": null,
      "notes_en": null,
      "notes_de": null,
      "notes_uk": null,
      "latitude": 53.400719,
      "longitude": 14.59911,
      "monday": {
        "opening_hours": "10:00–17:15",
        "notes_pl": null,
        "notes_en": null,
        "notes_de": null,
        "notes_uk": null
      },
      "tuesday": {
        "opening_hours": "10:00–17:15",
        "notes_pl": null,
        "notes_en": null,
        "notes_de": null,
        "notes_uk": null
      },
      "wednesday": {
        "opening_hours": "10:00–17:15",
        "notes_pl": null,
        "notes_en": null,
        "notes_de": null,
        "notes_uk": null
      },
      "thursday": {
        "opening_hours": "10:00–17:15",
        "notes_pl": null,
        "notes_en": null,
        "notes_de": null,
        "notes_uk": null
      },
      "friday": {
        "opening_hours": "10:00–17:15",
        "notes_pl": null,
        "notes_en": null,
        "notes_de": null,
        "notes_uk": null
      },
      "saturday": {
        "opening_hours": null,
        "notes_pl": null,
        "notes_en": null,
        "notes_de": null,
        "notes_uk": null
      },
      "sunday": {
        "opening_hours": null,
        "notes_pl": null,
        "notes_en": null,
        "notes_de": null,
        "notes_uk": null
      },
      "updated_at": "2023-05-19T19:38:57.000000Z"
    },

    ...

  ]
}

• int id – Kennung des Fahrkartenschalters
• string name – Name des Fahrkartenschalters
• string type_symbol – Symbol des Schaltertyps
• string type_name_pl – Typbezeichnung auf Polnisch
• string type_name_en – Typbezeichnung auf Englisch
• string type_name_de – Typbezeichnung auf Deutsch
• string type_name_uk – Typbezeichnung auf Ukrainisch
• string|null address – Adresse des Schalters
• string|null phone – Telefonnummer des Schalters
• string|null notes_pl – Zusatzinformationen auf Polnisch
• string|null notes_en – Zusatzinformationen auf Englisch
• string|null notes_de – Zusatzinformationen auf Deutsch
• string|null notes_uk – Zusatzinformationen auf Ukrainisch
• float latitude – geografische Breite des Schalters
• float longitude – geografische Länge des Schalters
• object monday, tuesday, wednesday, thursday, friday, saturday, sunday – Öffnungszeiten je Wochentag
  • string|null opening_hours – Öffnungszeiten
  • string|null notes_pl – Zusatzinformationen auf Polnisch
  • string|null notes_en – Zusatzinformationen auf Englisch
  • string|null notes_de – Zusatzinformationen auf Deutsch
  • string|null notes_uk – Zusatzinformationen 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.