biuro@datadrive.pl530 112 000

API systemu zarządzania flotą

Program kadrowy, księgowość i intranet firmy potrzebują danych o pojazdach, które są już w systemie flotowym. API systemu zarządzania flotą DataDrive, czyli interfejs programistyczny do wymiany danych między programami, przekazuje je tam bez ręcznego przepisywania kosztów, przydziałów i rezerwacji. Twój dział IT łączy z DataDrive własne systemy firmy przez udokumentowane API typu REST w standardzie OData v4.

Umów prezentację Wszystkie moduły
Programista przy laptopie łączy system DataDrive z innymi programami firmy przez API

  • API REST z danymi w JSON.

  • Zapytania w standardzie OData v4.

  • Token OAuth2 / JWT dla konta technicznego.

  • Dokumentacja OpenAPI z przykładami.

Co zyskujesz z API systemu zarządzania flotą

To samo, co na ekranie. Interfejs użytkownika korzysta z tej samej warstwy usług co API. Operację, którą pracownik wykona w przeglądarce, Twój program wykona przez API.

Zmiany widać od razu. Rekord zapisany przez API od razu pojawia się w interfejsie, raportach i regułach alertów. Zmiana wpisana przez pracownika trafia do API tak samo szybko.

Uprawnienia jak w systemie. Przy każdym zapytaniu obowiązują te same role i uprawnienia co w interfejsie. Konto integracyjne czyta i zmienia tylko dane, do których administrator dał mu dostęp.

Ślad w dzienniku zdarzeń. Każda operacja wykonana przez API zapisuje się w dzienniku zdarzeń z kontem, czasem i zmienionym obiektem.

Integracje przetrwają rozbudowę. Interfejs programistyczny jest wersjonowany. Nowe moduły dochodzą do niego bez zmian, które psułyby działające połączenia.

Połączenie przy wdrożeniu. Systemy, które wskażesz, nasz zespół podłącza do DataDrive już przy wdrożeniu. Gotowe połączenia z KSeF, GUS i kartami paliwowymi opisujemy na stronie Integracje.

Zasoby, zapytania i dostęp

Dane wracają w formacie JSON. Zapytania budujesz według OData v4, otwartego standardu odpytywania danych przez REST, więc filtry i dane powiązane działają od razu, bez osobnych punktów dostępu pisanych dla jednej firmy.

Co udostępnia API

  • Pojazdy i ich przypisania
  • Jednostki organizacyjne i użytkownicy
  • Koszty i faktury
  • Polisy i szkody
  • Naprawy i opony
  • Rezerwacje
  • Parkingi, miejsca i karty dostępu
  • Alerty
  • Odczyt, tworzenie, zmiana i usuwanie logiczne, przy którym rekord zostaje w historii

Zapytania w OData v4

  • Filtrowanie wyników
  • Sortowanie
  • Stronicowanie długich list
  • Wybór pól, które wracają w odpowiedzi
  • Dane powiązane w jednym zapytaniu
  • Przykład: pojazdy jednej jednostki organizacyjnej razem z kosztami z ostatniego kwartału

Konto techniczne. Integracja łączy się przez osobne konto techniczne. Administrator zakłada je, zawęża do odczytu albo kilku modułów i natychmiast cofa dostęp, gdy trzeba.

Logowanie tokenem. Zewnętrzny system uwierzytelnia się tokenem OAuth2 / JWT, czyli cyfrowym kluczem dostępu. Administrator dodaje token API na karcie użytkownika w module administracji.

Dokumentacja OpenAPI. Interaktywna dokumentacja w standardzie OpenAPI (Swagger) opisuje wszystkie zasoby i podaje przykłady zapytań. Wywołania przetestujesz w samej dokumentacji.

Typowe zastosowania API

Przez API dane płyną w obie strony, z DataDrive do innych programów firmy i z nich z powrotem do DataDrive.

System kadrowy. Program kadrowo-organizacyjny firmy dostaje z DataDrive przydziały pojazdów do pracowników i użytkowników.

Finanse i księgowość. Do systemu finansowo-księgowego trafiają zestawienia kosztów floty dla pojazdu, jednostki organizacyjnej, kategorii albo okresu.

Intranet i zgłoszenia. Inne systemy firmy same rejestrują zdarzenia w DataDrive. Pracownik składa w intranecie rezerwację pojazdu, a zgłoszenie szkody przychodzi z programu, w którym je przyjęto.

Hurtownia danych i BI. Dane z DataDrive zasilają firmową hurtownię danych albo narzędzie BI, czyli program do analiz biznesowych, cyklicznie albo na żądanie.

Powiązane moduły

Pytania i odpowiedzi

Czy DataDrive ma otwarte API?

Tak. System ma otwarte, udokumentowane API, przez które podłączysz programy swojej firmy. Obejmuje pojazdy, koszty, faktury, polisy, rezerwacje, parkingi i pozostałe zasoby z listy na tej stronie.

Gdzie znajdę dokumentację API?

Interaktywną dokumentację w standardzie OpenAPI dostają administratorzy po stronie klienta. Każdy zasób ma w niej opis i przykładowe zapytania.

Jak zabezpieczony jest dostęp do API?

Zewnętrzny program loguje się tokenem OAuth2 / JWT przypisanym do konta technicznego. Przy każdym zapytaniu DataDrive sprawdza uprawnienia tego konta, a wykonane operacje trafiają do dziennika zdarzeń.

Czy konto integracyjne może tylko odczytywać dane?

Tak. Konto techniczne dostaje wtedy sam odczyt, bez prawa do zmian. Administrator może też ograniczyć je do wybranych modułów.

Co się stanie z integracją, gdy w systemie pojawią się nowe moduły?

Działa dalej. Nowe moduły trafiają do API automatycznie, a wersjonowanie interfejsu chroni istniejące integracje przed zmianami, które by je zepsuły.

W jakim formacie API zwraca dane?

W formacie JSON. Zgodność ze standardem OData v4 oznacza, że w zapytaniu wybierasz pola, filtrujesz, sortujesz i pobierasz dane powiązane.

Porozmawiajmy o Twojej flocie

Pokażemy system online albo na spotkaniu u Ciebie. Możesz też poprosić o konto demo. Na zapytania odpowiadamy w ciągu 24 godzin.

Umów prezentację
Telefon530 112 000
E‑mailbiuro@datadrive.pl
Adresul. Modlińska 175,
05-110 Jabłonna