VEHIZEN - API

API

1. Authentification

Les fonctions de l'API nécessitent l'utilisation d'un token bearer (à insérer dans les headers des requêtes Http) et donc d'une authentification préalable via la fonction token.
La route pour récupérer le token est https://geo.vehizen.com/token en POST.

le body doit être sous la forme x-www-form-urlencoded avec les champs suivant :

grant_type: "password"
username: "login"
password: "mot de passe"

Voici des identifiants pour effectuer vos tests :

identifiant : test_api
mot de passe : test_api_2024

Un couple identifiant/mot de passe différent sera nécessaire pour chaque client.

2. Récupération liste véhicule

La route pour récupérer la liste des véhicules est la suivante :
https://geo.vehizen.com/Help/Api/GET-api-v2-vehicle-user_AgenceId_AgenceName_GroupId_GroupName_Vin_CompatibleTachodowload_Archived

Pour récupérer la liste des véhicules actifs utilisez la route : https://geo.vehizen.com/api/v2/vehicle/user?archived=false

3. Récupération de la liste des conducteurs

Pour récupérer la liste des conducteurs vous pouvez utiliser la fonction suivante :

https://geo.vehizen.com/Help/Api/GET-api-v2-driver-user_CardNumber_ValidContract_WithAffectedCard

Le paramètre optionnel "ValidContract=true" permet de filtrer les conducteurs en ne retournant que les conducteurs actifs (en filtrant les conducteurs archivés).
https://geo.vehizen.com/api/v2/driver/user?ValidContract=true

4. Récupération des dernières informations connues de tous les véhicules

La route pour récupérer les dernières informations (notamment la position GPS) est la suivante:

https://geo.vehizen.com/Help/Api/GET-api-v2-position-vehicle-trackingPartner

5. Récupération des données des véhicules

https://geo.vehizen.com/Help/Api/GET-api-v2-efficient-report-dioxide_DateStart_DateEnd

Les données retournées sont celles que vous pouvez consulter dans le module performance de la plate-forme Vehizen.

6. Récupération liste points GPS / véhicule période de date à date

https://geo.vehizen.com/Help/Api/GET-api-v2-reportActivity-gps-numericCards-cardNumber_DateStart_DateEnd

7. Récupération des fichiers légaux

https://geo.vehizen.com/api/v2/legalArchivingController/GetFiles?type=vehicle&identifier=XLRTEH4300G245718&dateStart=2022-09-01T00:00:00&dateEnd=2022-11-10T00:00:00

https://geo.vehizen.com/api/v2/legalArchivingController/GetFiles?type=driver&identifier=10000007354650&dateStart=2022-09-01T00:00:00&dateEnd=2022-11-10T00:00:00

8. Récupération des services des conducteurs

https://geo.vehizen.com/Help/Api/GET-api-v2-reportActivity-drivers-services_DateStart_DateEnd

Les durées de travail/conduite/repos/dispo sont exprimées en secondes

9. Récupération des données écoconduite

Pour récupérer les données écoconduite d'un conducteur il faut utiliser la fonction suivante :

https://geo.vehizen.com/Help/Api/GET-api-v2-ecodrive-driver-cardNumber-ByPeriodUtc_DateStart_DateEnd

Pour récupérer les données éco-conduite de tous les conducteurs il faut utiliser la fonction suivante :

https://geo.vehizen.com/Help/Api/GET-api-v2-ecodrive-drivers-ByPeriodUtc_DateStart_DateEnd