API
Dane z floty mają największą wartość tam, gdzie na co dzień pracują Twoi ludzie: w systemie spedycyjnym, ERP, programie kadrowo-płacowym, hurtowni danych czy w portalu dla klientów. B2B API SignatiGPS udostępnia pozycje pojazdów, trasy, postoje, tankowania, raporty, nagrania z kamer i dane biznesowe w formacie JSON – tak, żeby połączyć monitoring floty z Twoimi systemami bez ręcznego przepisywania danych.
Najważniejsze cechy
- REST i JSON – proste zapytania HTTPS pod adresem
/api/v1/, odpowiedzi wyłącznie w JSON. - Klucz API przypisany do użytkownika – przekazywany w nagłówku
SignatiGPS-API-Key; integracja widzi dokładnie te pojazdy i dane, do których ma dostęp użytkownik klucza. - Uprawnienia jak w panelu – dostęp do kierowców, grup czy edycji obiektów zależy od uprawnień nadanych użytkownikowi.
- Logowanie dla aplikacji mobilnych – osobny tryb z tokenem użytkownika i jego odświeżaniem.
- Dokumentacja OpenAPI – pełny opis endpointów, parametrów i odpowiedzi udostępniamy klientom wdrażającym integrację.
Dostępne endpointy
Obiekty i dane bieżące
GET /objects,GET /objects/{id}– lista pojazdów i maszyn z danymi z karty obiektu, statystykami z 30 dni i liczbą załączników; z parametreminclude=currenttakże bieżący przebieg, paliwo lub poziom naładowania baterii, napięcie, adres, ostatnio zidentyfikowany kierowca, dane z tachografu i ostatnie zdjęcia z kamer,GET /objects/telemetry– aktualna telemetria i pozycje obiektów,PATCH /objects/{id}– aktualizacja danych obiektu, np. VIN, notatek, numerów inwentarzowych, nazw czujników i zakresów temperatur (zgodnie z uprawnieniami do edycji).
Historia przejazdów
GET /objects/{id}/trips– przejazdy w wybranym okresie,GET /objects/{id}/breaks– postoje, opcjonalnie z adresami,GET /objects/{id}/refuelsorazGET /objects/refuels– tankowania pojedynczego pojazdu albo całej floty.
Raporty
GET /reports/objects/daily,GET /reports/objects/{id}/daily– dzienne zestawienia dla floty lub pojazdu,GET /reports/fleet/summary– podsumowanie floty za wybrany okres.
Wideomonitoring
GET /objects/{id}/video/latest-photo– ostatnie zdjęcie z kamery,GET /objects/{id}/video/photos,GET /objects/{id}/video/videos– listy zdjęć i nagrań ze stronicowaniem oraz tymczasowe linki do podglądu i pobrania.
Kierowcy, grupy i miejsca
GET /drivers,GET /drivers/{id},PATCH /drivers/{id}– kartoteka kierowców z danymi kontaktowymi i dokumentami,GET /groups,GET /groups/{id}/objects– grupy obiektów i ich skład,GET /poi– punkty POI i strefy,GET /geocoding/reverse– zamiana współrzędnych na adres.
Wydatki, pliki i zdarzenia
/expenses– wydatki floty, a/expenses/scan– rozpoznawanie paragonów ze zdjęć,/files– zdjęcia i dokumenty obiektów: dodawanie, opis, ustawianie zdjęcia głównego, usuwanie,GET /objects/{id}/attachment-events– zdarzenia z osi czasu pojazdu wraz z plikami.
Planowanie tras i powiadomienia
/route_groups,POST /route_groups/import– import tras i zleceń do planera z Twojego systemu,GET /notifications– powiadomienia, a/push-tokens– rejestracja urządzeń mobilnych do powiadomień push.
Konto i słowniki
GET /account– kontekst klucza: użytkownik, firma i uprawnienia,GET /reference– słowniki: waluty, rodzaje paliw, typy obiektów i marki pojazdów,GET /plates/svg– tablica rejestracyjna jako grafika do wyświetlania we własnych aplikacjach.
Bezpieczeństwo i limity
- Izolacja danych – każde zapytanie jest przypisane do użytkownika i firmy; nie da się pobrać danych spoza uprawnień.
- Limity zapytań – liczone osobno dla każdego klucza i endpointu, na minutę i na dobę; lekkie zapytania (obiekty, słowniki) mają wyższe limity, a ciężkie (przejazdy, raporty, nagrania) niższe.
- Przejrzyste nagłówki – odpowiedzi zawierają liczbę pozostałych zapytań (
X-RateLimit-*), a po przekroczeniu limitu API zwraca kod 429 z informacją, kiedy ponowić zapytanie. - Logi API – historia wywołań dostępna w panelu, przydatna przy uruchamianiu i diagnozowaniu integracji.
- Kontrola kluczy – klucz można w każdej chwili wyłączyć bez jego usuwania.
Przykłady zastosowań
- TMS i spedycja – automatyczne pobieranie pozycji i czasów przyjazdu do zleceń oraz import tras do planera.
- ERP i księgowość – przebiegi, tankowania i wydatki przypisane do pojazdów i centrów kosztów.
- Kadry i płace – przejazdy i postoje jako podstawa rozliczania czasu pracy i delegacji.
- BI i raportowanie – dzienne dane floty w hurtowni danych, obok sprzedaży i logistyki.
- Portal klienta – status dostawy i lokalizacja pojazdu we własnej aplikacji dla Twoich klientów.
- Aplikacje mobilne – własna aplikacja dla kierowców lub serwisantów z danymi z SignatiGPS.
Jakie dane można analizować w samym panelu, opisujemy na stronie Raporty i analizy, a o organizowaniu floty w grupy – w artykule Grupy, typy i filtry obiektów.
Chcesz zintegrować SignatiGPS ze swoim systemem?
Wypełnij formularz – przygotujemy klucz API, przekażemy dokumentację i pomożemy dobrać endpointy do Twojej integracji.