W dzisiejszym artykule omówimy nowość, która pojawiła się na rynku a dokładnie udostępnienie API przez pośrednika usług przewozowych Bolt. Bolt jest pierwszą aplikacją, która udostępniła możliwość integracji z API swoim partnerom flotowym. Niestety Bolt poinformował o fakcie udostępnienia API tylko większych partnerów flotowych – a Ci mniejsi zdani są na siebie. Jeśli chodzi o pozostałe aplikacje, takie jak Uber czy FreeNow niestety w dalszym ciągu czekamy na możliwość integracji, chociażby podstawowej jak to ma miejsce w przypadku Bolta.
Co daje nam integracja z API?
Integracja z API daje nam możliwość wykonywania zapytań do serwera, na dzień dzisiejszy tj. 25.07.2024 r. mamy dostępnych kilka endpointów na które możemy wykonywać zapytania. Poniżej możesz zobaczyć aktualnie dodane endpointy.
Warto poruszyć na ten moment tylko jeden endpoint – getFleetOrders. Dzięki tej ścieżce w szybki sposób możemy uzyskać szczegółowe informację na temat wszystkich zamówień w określonym czasie. Dane pozyskanego z tego API możemy wykorzystać np. do utworzenia kilometrówki dla urzędu skarbowego. W skład zwróconych danych wchodzą między innymi takie informacje:
- informację na temat punktu odbioru, zakończenia kursu oraz informację na temat punktów pośrednich
- odległość przejazdu
- data zaakceptowania
- data zakończenia przejazdu
- informacja na temat statusu zamówienia (zrealizowano, odrzucono itp.)
- cena za przejazd
- metoda płatności
- numer rejestracyjny pojazdu
Jak uzyskać dostęp do API Bolta?
Aby uzyskać dostęp do API Bolta musimy wygenerować dwa klucze client_id oraz client_secret. Aby to zrobić zaloguj się do swojego panelu floty i przejdź w prawym górnym rogu do Ustawień, następnie wejdź w zakładkę API.
Po wejściu w zakładkę API należy wygenerować dane, naciskając przycisk Wygeneruj dane. Następnie zapisz w bezpiecznym miejscu klucze dostępu, lub przekaż je swojemu programiście. Wykorzystując client_id oraz client_secret możemy uzyskać token JWT dzięki któremu możemy realizować pozostałe zapytania.
Uzyskanie tokenu JWT
Do autoryzacji żądań używamy przepływu danych uwierzytelniających klienta OAuth2. Mówiąc najprościej, każde żądanie musi mieć nagłówek Authorization z tokenem okaziciela. Możesz uzyskać token z punktu końcowego poniżej:
https://oidc.bolt.eu/tokenParametry zapytania prezentują się następująco:
curl --location --request POST 'https://oidc.bolt.eu/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=YOUR_CLIENT_ID' \
--data-urlencode 'client_secret=YOUR_SECRET' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'scope=fleet-integration:api'Serwer w odpowiedzi powinien zwrócić Ci następujący obiekt:
{
"access_token": "YOUR_TOKEN",
"expires_in": 600,
"token_type": "Bearer",
"scope": "fleet-integration:api"
}Uzyskany w ten sposób access_token możesz wykorzystać przy uzyskiwaniu danych z endpointów.
Jeśli chciałbyś abyśmy wykonali dla Ciebie integrację z Bolt API to serdecznie zachęcamy do kontaktu. W CABGO stawiamy na automatyzację procesów, abyś miał czas na poważnie zając się swoją flotą.
