Aller au contenu principal

Créer des clés API Growth+This feature requires the Growth+ plan or higher

Les clés API permettent à des applications externes de se connecter à votre compte EquipDash en toute sécurité. Chaque clé peut être limitée à certaines opérations seulement, ce qui protège vos données.


Générer une nouvelle clé API​

  1. Cliquez sur Paramètres dans le menu latéral.
  2. Sélectionnez API et intégrations dans le menu des paramètres.
  3. Dans l'onglet Clés API, cliquez sur + Créer une clé API.
  4. Renseignez les champs suivants :
    • Nom -- un libellé clair pour cette clé (par exemple « Intégration site web », « Application mobile », « Connexion Zapier »).
    • Autorisations -- choisissez les permissions que cette clé doit avoir. Consultez Les autorisations de l'API expliquées pour le détail de chaque autorisation.
    • Date d'expiration (facultatif) -- indiquez une date après laquelle la clé cessera de fonctionner. Laissez ce champ vide si la clé ne doit pas expirer.
    • Liste d'adresses IP autorisées (facultatif) -- limitez la clé à certaines adresses IP pour plus de sécurité. Saisissez une adresse IP par ligne.
  5. Cliquez sur Créer.

The API & Integrations settings page


Copier votre clé API​

Une fois la clé créée, EquipDash affiche la clé API complète une seule fois.

  1. Copiez la clé tout de suite et conservez-la dans un endroit sûr (par exemple un gestionnaire de mots de passe ou une variable d'environnement).
  2. Cliquez sur Terminé pour fermer la fenêtre.
attention

La clé API complète n'est affichée qu'une seule fois. Une fois cette fenêtre fermée, vous ne verrez plus que le préfixe de la clé (par exemple edsk_live_abc1...). Si vous perdez la clé, vous devrez en créer une nouvelle.


Gérer vos clés existantes​

Toutes vos clés API figurent sur la page API et intégrations, dans l'onglet Clés API. Pour chaque clé, vous pouvez voir :

  • Nom -- le libellé que vous lui avez donné.
  • Préfixe de la clé -- les premiers caractères de la clé, pour l'identifier.
  • Autorisations -- ce à quoi la clé a accès.
  • Date de création -- la date à laquelle la clé a été générée.
  • Dernière utilisation -- la dernière fois que la clé a servi à envoyer une requête API.
  • Statut -- si la clé est active ou révoquée.

Modifier une clé​

  1. Cliquez sur le nom de la clé pour afficher ses détails.
  2. Vous pouvez modifier le Nom, les Autorisations, la Date d'expiration et la Liste d'adresses IP autorisées.
  3. Cliquez sur Mettre à jour.

Révoquer une clé​

Si une clé est compromise ou si vous n'en avez plus besoin :

  1. Cliquez sur le bouton Révoquer à côté de la clé.
  2. Confirmez l'action.

La révocation d'une clé bloque immédiatement toutes les requêtes API qui utilisent cette clé. Cette action est irréversible -- si besoin, vous devrez créer une nouvelle clé.

Supprimer une clé​

Pour supprimer définitivement une clé et son historique de requêtes :

  1. Cliquez sur le bouton Supprimer à côté de la clé.
  2. Confirmez l'action.

Utiliser votre clé API​

Ajoutez votre clé API dans l'en-tête Authorization de chaque requête API :

Authorization: Bearer edsk_live_your_full_key_here

Pour la documentation complète de l'API, consultez la référence de l'API EquipDash.