Clés API du projet

Une Clé API permet de connecter un service externe à ce projet, pour qu'il lance vos applications par programme plutôt que depuis le site. Depuis la page Accès API, vous créez une clé, consultez celles dont vous disposez déjà, et ouvrez l'une d'elles pour la renommer, la désactiver ou la supprimer. Un raisonnement lancé avec une clé affiche API comme origine dans votre historique.

Avant de commencer — Créer une clé API demande d'être administrateur du projet. La clé complète n'est affichée qu'une seule fois, juste après sa création. Copiez-la avant de quitter la page.

Créer une clé API

1. Ouvrez la page Accès API du projet. Si vous n'en avez encore aucune, l'écran affiche Aucun accès API et Aucune clé API n'a été créée sur ce projet., avec un bouton Créer une clé API.
2. Cliquez sur Créer une clé API.
3. Saisissez un Nom qui vous rappelle à quoi sert la clé — Exemple : Production, test, intégration. — puis cliquez sur Suivant.
4. La nouvelle clé s'affiche en entier une seule fois, avec le rappel Important : copiez cette clé maintenant, elle ne sera plus affichée par la suite. Copiez-la et conservez-la en lieu sûr.

La clé commence par sk-project-. Ensuite, seul un aperçu court (sk-project-... suivi des derniers caractères) est affiché.

Important — Si vous ne copiez pas la clé avant de quitter la page, vous ne pourrez plus la revoir. Supprimez-la et créez-en une nouvelle si vous la perdez.

Consulter vos clés API

1. Ouvrez la page Accès API.
2. La liste présente chaque clé par sa Clé API (nom et aperçu), son Statut, la personne qui l'a Créée par, et sa date sous Créé le.
3. Cliquez sur Détail sur une clé pour l'ouvrir.

Renommer ou désactiver une clé

1. Ouvrez la page Accès API, puis cliquez sur Détail sur la clé.
2. Sur Détail d'une clé API, modifiez le Nom, ou passez le Statut à Activée ou Désactivée.
3. Cliquez sur Enregistrer.

Le message La clé API a été mise à jour. s'affiche.

Important — Désactiver une clé bloque immédiatement tous les appels qui l'utilisent. Repassez-la à Activée pour autoriser à nouveau les appels.

Supprimer une clé

1. Ouvrez la page de détail de la clé.
2. Dans la section de suppression, cliquez sur Supprimer.

La clé est retirée et ne pourra plus être utilisée. Tout service qui s'en sert cessera de fonctionner : mettez ces services à jour au préalable.