API – kasy biletowe
Informacje o kasach biletowych.
- Endpoint:
GET https://www.zditm.szczecin.pl/api/v1/ticket-offices
- Typ danych: application/json
- Częstotliwość aktualizacji: w miarę potrzeb
Struktura danych
{
"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
– identyfikator kasy biletowej - string
name
– nazwa kasy biletowej - string
type_symbol
– symbol typu kasy biletowej - string
type_name_pl
– nazwa typu kasy biletowej w języku polskim - string
type_name_en
– nazwa typu kasy biletowej w języku angielskim - string
type_name_de
– nazwa typu kasy biletowej w języku niemieckim - string
type_name_uk
– nazwa typu kasy biletowej w języku ukraińskim - string|null
address
– adres kasy biletowej - string|null
phone
– numer telefonu do kasy biletowej - string|null
notes_pl
– dodatkowe informacje w języku polskim - string|null
notes_en
– dodatkowe informacje w języku angielskim - string|null
notes_de
– dodatkowe informacje w języku niemieckim - string|null
notes_uk
– dodatkowe informacje w języku ukraińskim - float
latitude
– współrzędne geograficzne kasy biletowej (szerokość geograficzna) - float
longitude
– współrzędne geograficzne kasy biletowej (długość geograficzna) - object
monday
, objecttuesday
, objectwednesday
, objectthursday
, objectfriday
, objectsaturday
, objectsunday
– obiekty zawierające informacje o godzinach otwarcia kas biletowych w poszczególne dni tygodnia (poniedziałek, wtorek, środa, czwartek, piątek, sobota, niedziela)- string|null
opening_hours
– godziny otwarcia kasy biletowej - string|null
notes_pl
– dodatkowe informacje w języku polskim - string|null
notes_en
– dodatkowe informacje w języku angielskim - string|null
notes_de
– dodatkowe informacje w języku niemieckim - string|null
notes_uk
– dodatkowe informacje w języku ukraińskim
- string|null
- string
updated_at
– moment ostatniej aktualizacji danych
Informacje ogólne
- Dane udostępniane są bezpłatnie, do wykorzystania w dowolnym celu, a ich użycie nie wymaga wcześniejszego zgłoszenia.
- Zarząd Dróg i Transportu Miejskiego w Szczecinie nie gwarantuje, że udostępniane dane są prawidłowe i kompletne. Nie ponosi również odpowiedzialności za szkody lub niewłaściwe decyzje podjęte na ich podstawie.
- W produkcie korzystającym z danych (aplikacja, strona internetowa, publikacja itp.) zalecane jest podanie źródła danych, tj. Zarząd Dróg i Transportu Miejskiego w Szczecinie lub – w formie skróconej – ZDiTM Szczecin.
- W produkcie korzystającym z danych (aplikacja, strona internetowa, publikacja itp.) zalecane jest – jeżeli jest to możliwe – umieszczenie odsyłacza do niniejszej strony lub do strony głównej.
- Klient powinien rozpoznawać i honorować nagłówki HTTP
Cache-Control
iETag
. - Liczba żądań do API jest limitowana. Limit jest wspólny dla wszystkich endpointów i wynosi 100 żądań na minutę na adres IP. Nagłówek
X-RateLimit-Remaining
zawiera liczbę żądań pozostałych w ramach dostępnego limitu. Po wyczerpaniu limitu zwracany jest kod odpowiedzi HTTP429
. Nagłówek odpowiedziX-RateLimit-Reset
zawiera wówczas uniksowy timestamp równy czasowi zresetowania limitu, a nagłówekRetry-After
zawiera liczbę sekund pozostałych do zresetowania limitu. - Jeżeli to możliwe, w nagłówku
User-Agent
żądania należy umieścić informację o podmiocie korzystającym z danych (np. nazwa aplikacji, strony internetowej, adres URL). - W przypadku nadmiernego obciążania serwera ZDiTM Szczecin zastrzega sobie prawo do częściowego lub całkowitego zablokowania dostępu do API.