Aller au contenu
Logo FleeteeLogo Fleetee

Clés d’API et webhooks

Une clé d’API ouvre vos données à un logiciel, un webhook prévient vos outils d’un événement. Les deux se créent dans les Réglages, par l’administrateur, et se limitent au strict nécessaire.

Objectif

À la fin de cette leçon, vous saurez ouvrir vos données à un logiciel avec une clé d’API, et prévenir vos outils avec un webhook, sans ouvrir plus que nécessaire.

L’essentiel

Location Démo veut relier son outil de suivi commercial à Fleetee. Deux portes, toutes deux réservées à l’administrateur :

  • une clé d’API : l’outil appelle Fleetee pour lire ou écrire vos données (locations, clients, véhicules, factures…) ;
  • un webhook : Fleetee prévient l’outil dès qu’un événement se produit (« Une location est confirmée »).

Dans Réglages › Clés d’API, Julie clique sur « Créer une clé » : un nom, l’accès (lecture seule ou lecture et écriture), l’API v3 et les agences. La clé et son secret ne s’affichent qu’une fois : elle les copie dans un endroit sûr.

La page Réglages › Clés d’API : la liste des clés avec leur nom, leur accès, leur version, leurs agences et leur statut

Dans Réglages › Webhooks, « Ajouter un webhook » : l’adresse fournie par l’outil, les événements à cocher, puis un essai. Chaque envoi est signé, et Fleetee réessaie en cas d’échec. Pour Zapier, Make ou n8n, c’est la même chose : l’outil donne une adresse, Fleetee y envoie.

La page Réglages › Webhooks : deux webhooks avec leur état, ce qu’ils reçoivent et le dernier envoi, et le bouton « Ajouter un webhook »

Une clé lit les données de vos clients. Ouvrez le minimum (lecture seule, agences limitées), une clé par outil. Une clé perdue ou exposée se révoque tout de suite, puis se remplace.

Les gestes clés

  1. Créez une clé

    Réglages › Clés d’API › « Créer une clé » : nom, accès, API v3, agences. Copiez la clé et le secret.

  2. Limitez-la

    « Modifier » sur sa ligne : « Lecture seule », « Limiter à certaines agences ».

  3. Ajoutez un webhook

    Réglages › Webhooks › « Ajouter un webhook » : adresse, événements, essai.

  4. Protégez vos clés

    « Renouveler le secret » si le secret est perdu, « Révoquer » si la clé est exposée.

À vous de jouer

Faites le ménage

Ouvrez Réglages › Clés d’API et relisez chaque clé : à quoi sert-elle, a-t-elle besoin d’écrire, de toutes les agences ? Notez celles à limiter ou à révoquer, puis parlez-en avec la personne qui utilise l’outil avant de couper quoi que ce soit.

Pour aller plus loin

Vérifiez vos acquis

  1. Julie crée une clé pour un outil qui ne fait que lire les locations d’une agence. Quel accès choisit-elle ?

  2. Julie a fermé le panneau sans copier le secret de la clé. Que fait-elle ?

  3. Julie veut que son outil soit prévenu à chaque location confirmée. Que crée-t-elle ?

Lire l’article

Répondez juste à toutes les questions pour valider la leçon.

Progression gardée sur cet appareil. Bientôt avec votre Compte Fleetee.

Demander à l’assistant : « … »bientôt