Uzyskaj programowy dostęp do danych monitorowania pojazdów za pomocą naszego zewnętrznego API. Idealne do integracji danych RAM Tracking z własnymi systemami, aplikacjami lub pulpitami nawigacyjnymi.
Pierwsze kroki
Co będzie potrzebne:
Aktywne konto RAM Tracking
Podstawowa znajomość API i zapytań HTTP
Narzędzia programistyczne, takie jak Postman lub preferowany język programowania
Pełna dokumentacja API: https://api.qaifn.co.uk/swagger/docs
Uzyskaj swoje dane API
Zaloguj się do portalu RAM Tracking
Kliknij ikonę profilu w prawym górnym rogu
Wybierz „Get API Key” z menu rozwijanego
Kliknij przycisk „Get API Key”, aby wygenerować swoje dane uwierzytelniające
Otrzymasz:
Client ID
Client Secret
Nazwę użytkownika i hasło API
Jak korzystać z API
Krok 1: Pobierz token dostępu – Wyślij żądanie do naszego endpointu uwierzytelniającego z danymi uwierzytelniającymi: https://auth.qaifn.co.uk/oauth/token. Uwzględnij nazwę użytkownika API, hasło, client ID i secret.
Krok 2: Wykonuj żądania API – Użyj tokena dostępu, aby pobierać dane z naszych endpointów API: https://api.qaifn.co.uk/api/v1/vehicle/for-account. Dodaj token jako Bearer w nagłówku Authorization.
Ważne limity
Limit zapytań: maksymalnie 3 zapytania na minutę na endpoint. Zapobiega to przeciążeniu serwerów i zapewnia niezawodność usługi dla wszystkich użytkowników.
Synchronizacja danych: dane pojazdów dostępne są w czasie rzeczywistym, więc zawsze uzyskasz aktualne informacje.
Dostępne dane
Nasze API umożliwia dostęp do pełnych danych monitorowania pojazdów, w tym:
Lokalizacje i trasy pojazdów
Prędkość i styl jazdy
Historia tras
Informacje o kierowcach
Stan i diagnostyka pojazdów
Pełną listę endpointów i pól danych znajdziesz w dokumentacji Swagger podanej powyżej.
Rozważ użycie Webhooków
Zamiast polling API, rozważ użycie webhooków. Zamiast wielokrotnie pobierać nowe dane, webhooki automatycznie przesyłają informacje do Twojego systemu, gdy wystąpi zdarzenie.
Korzyści z webhooków
Dane w czasie rzeczywistym
Brak limitów zapytań
Bardziej efektywne niż polling
Mniejsze obciążenie serwera
[Dowiedz się więcej o webhookach]
Uzyskaj pomoc
Ważne: Nasz zespół wsparcia nie może udzielać pomocy programistycznej dla zewnętrznego API. Przygotowaliśmy jednak kolekcję Postman, aby ułatwić rozpoczęcie pracy.
Wystarczy skopiować JSON do pliku, zaimportować go do Postman i wprowadzić swoje dane uwierzytelniające, aby połączyć się z zewnętrznym API.
{"accountId":3,"vehicleRegistration":"7567453451","vehicleId":345934,"vehicleEvent":"DRIVING","driverName":"NW","dateTime":"2023-01-10 11:56:09","location":"M1, London, England, NW7 3","latitude":51.6289668131,"longitude":-0.2625989914,"speedKph":57,"speedMph":35,"geofenceName":null,"congestionZone":null,"externalVoltage":14.5,"internalVoltage":null,"odometer":72185.0}