API – biletomaty stacjonarne

Informacje o stacjonarnych automatach biletowych.

Endpoint: GET https://www.zditm.szczecin.pl/api/v1/ticket-machines
Typ danych: application/json
Częstotliwość aktualizacji: w miarę potrzeb

Struktura danych

{
  "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 – identyfikator automatu biletowego
string location – opis lokalizacji automatu biletowego
float latitude – współrzędne geograficzne automatu biletowego (szerokość geograficzna)
float longitude – współrzędne geograficzne automatu biletowego (długość geograficzna)
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.
Zalecane jest podanie źródła danych, tj. Zarząd Dróg i Transportu Miejskiego w Szczecinie lub – w formie skróconej – ZDiTM Szczecin.
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 i ETag.
Liczba żądań do API jest limitowana. Limit jest wspólny dla wszystkich endpointów i wynosi 6000 żądań na godzinę 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 HTTP 429. Nagłówek odpowiedzi X-RateLimit-Reset zawiera wówczas uniksowy timestamp równy czasowi zresetowania limitu, a nagłówek Retry-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.