Table des matières
L'API (Application Programming Interface) de Fleetio permet d'accéder aux ressources de données de Fleetio (par exemple, les Véhicules, les Entrées de compteurs et les Entrées de carburant) afin que les développeurs puissent créer des intégrations avec des systèmes logiciels tiers et/ou internes.
Pour qu'un tiers puisse accéder à l'API, une clé API doit être générée.
IMPORTATIONS : L'accès à l'API n'est disponible que pour les clients des plans Professional et Premium.
Qu'est-ce qu'une clé API ?
Une clé API sert de nom d'utilisateur et de mot de passe pour la partie externe accédant à vos données Fleetio.
AUTORISATIONS : Les clés API sont directement associées à l' utilisateur qui les crée ; par conséquent, toutes les données disponibles via l'API seront déterminées par les autorisations de cet utilisateur.
IMPORTANT : Les clés API peuvent être régénérées et/ou révoquées ; par conséquent, nous recommandons fortement que chaque application ou intégration se connectant à Fleetio se voie attribuer sa propre clé API.
Créer une clé API
- Accédez à votre menu Compte et sélectionnez Paramètres.
- Dans la barre latérale Paramètres, cliquez sur Gérer les clés API . Une nouvelle fenêtre de navigateur s'ouvrira.
- Cliquez sur le bouton + Ajouter une clé API .
- Ajoutez une étiquette pour mieux organiser vos clés API afin que la fonction de chaque clé soit claire, et sélectionnez la version de l'API dans le menu déroulant.
- Cliquez sur le bouton Enregistrer .
Une fois ajoutée, Fleetio affichera la clé API générée sous l'en-tête « Jeton » , à côté du libellé que vous avez créé précédemment.
Modifier ou révoquer l'accès
Pour modifier ou révoquer l'accès à l'API, survolez une clé API et cliquez sur le bouton Plus d'actions .
IMPORTANT : Les clés API doivent rester secrètes ; par conséquent, nous vous déconseillons fortement de les coller en ligne ou de les enregistrer dans un dépôt.
Jeton de compte
Pour que les requêtes de données soient traitées via l'API, un jeton de compte doit être fourni. Celui-ci figure sous votre clé API.
Les jetons de compte peuvent également être identifiés directement à partir de l'URL de n'importe quelle page de Fleetio.
Par exemple, si l'URL du tableau de bord Fleetio est https://secure.fleetio.com/abc123/dashboard , alors abc123 est le jeton de compte.
Requêtes API
La page Clés API inclut également un extrait de code entièrement fonctionnel pour le compte et la clé API, ainsi qu'un exemple d'utilisation du jeton issu de la clé API :
CONSEIL : Pour en savoir plus, consultez la documentation pour développeurs de Fleetio .
