Créer et gérer vos clés API

Les clés API donnent accès à l’API publique Skipcall. Elles se gèrent au niveau de l’organisation, dans Paramètres > Clés API, où vous trouverez aussi le lien vers la documentation.

Ouvrir l’écran des clés API

1. Cliquez sur votre nom, en bas à gauche, pour ouvrir le menu profil.
2. Cliquez sur Paramètres.
3. Ouvrez la rubrique Clés API.

L’écran indique « Gérez vos clés API pour accéder à l’API publique Skipcall. » et propose deux boutons : Voir la documentation et Créer une clé.

Créer une clé

1. Dans Paramètres > Clés API, cliquez sur Créer une clé.
2. Saisissez le Nom de la clé, par exemple Production, Staging ou le nom de l’outil qui l’utilisera.
3. Dans Accès aux workspaces, choisissez :
   • Tous les workspaces : la clé peut accéder à tous les workspaces actuels et futurs ;
   • Workspaces spécifiques : la clé n’accède qu’aux workspaces que vous sélectionnez.
4. Cliquez sur Créer la clé.

Le tableau des clés

Pour chaque clé, le tableau affiche :

• Nom : le nom choisi à la création ;
• Clé : la clé tronquée, qui commence par sk_live_ ;
• Workspaces : Tous les workspaces, ou le nom du workspace autorisé ;
• Créée le : la date de création ;
• Dernière utilisation : la date à laquelle la clé a servi pour la dernière fois, ou Jamais ;
• une corbeille pour supprimer la clé.

Révoquer une clé

1. Ouvrez Paramètres > Clés API.
2. Repérez la clé à révoquer. La colonne Dernière utilisation aide à repérer les clés qui ne servent plus (Jamais).
3. Cliquez sur la corbeille au bout de sa ligne.

Où trouver la documentation de l’API ?

Dans Paramètres > Clés API, cliquez sur Voir la documentation. Elle est aussi accessible directement sur docs.skipcall.app.

Questions fréquentes

L’API est-elle incluse dans mon forfait ?

Les API ouvertes figurent dans les quatre forfaits. Le détail est sur la page tarifs.

Comment limiter une clé à un seul workspace ?

À la création, choisissez Workspaces spécifiques au lieu de Tous les workspaces, puis sélectionnez le workspace voulu.

Une clé a pu être exposée, que faire ?

Supprimez-la avec la corbeille dans Paramètres > Clés API, puis créez-en une nouvelle et remplacez-la dans l’outil qui l’utilisait.