Gérer les clés API

La page API Keys vous permet de créer, d'afficher et de gérer les clés que vos applications utilisent pour appeler l'API FourA.

Afficher vos clés

La page affiche chaque clé à laquelle vous avez accès: vos clés personnelles et chaque clé appartenant à une organisation dont vous êtes membre. L'adhésion est ce qui accorde l'accès, donc un simple membre voit également les clés de l'organisation.

Column What it shows
Name Nom d'affichage et, si vous en avez défini une, la description
Owner Personal, ou le nom de l'organisation
Key Prefix Les premiers caractères de la clé, puis un masque (pk_live_a1b2••••••••), avec un bouton Reveal, ou une icône de cadenas sur une clé obsolète
Status Active ou Inactive
Created Date de création de la clé
Last Used Date à laquelle la clé a effectué une requête pour la dernière fois

Recherchez par nom ou description, filtrez par Active ou Inactive, et triez par Name, Owner, Status, Created ou Last Used. L'ordre de tri alterne entre décroissant, croissant, puis désactivé.

Le filtre Owner

Si vous appartenez à au moins une organisation, un menu déroulant Owner apparaît à côté du champ de recherche: Everything, Personal, ou une entrée par organisation. Il restreint la liste aux clés ayant ce propriétaire, et le même contrôle sur Overview, Metrics, Activity et Proxy suit votre sélection, afin que les cinq pages affichent toujours le trafic correspondant.

Créer une clé

Cliquez sur Create Key au-dessus de la liste (Create API key sur la page vide avant votre première clé) et renseignez les champs:

Field Required Description
Name Oui Un libellé descriptif, par exemple "production-scraper" ou "staging-test"
Description Non Notes sur l'utilisation de cette clé
Owner Oui si vous appartenez à une organisation Personal, ou toute organisation dont vous êtes membre. Le sélecteur n'apparaît que si vous en avez au moins une.

Tout membre d'une organisation peut créer une clé appartenant à celle-ci, quel que soit son rôle. C'est l'objectif de ce paramètre: l'utilisation d'une clé d'organisation est facturée au propriétaire de l'organisation, évitant ainsi à un développeur d'utiliser une clé personnelle qui lui serait directement facturée à la place de l'entreprise.

La clé complète est affichée une seule fois juste après sa création dans une boîte de dialogue prête à copier. Vous pouvez la réafficher plus tard avec Reveal. Les clés utilisent le préfixe pk_live_ et ressemblent à pk_live_a1b2c3d4e5f6.... Vous recevrez un e-mail confirmant la création de la clé.

Votre forfait définit le nombre de clés actives que vous pouvez détenir: vos clés personnelles ainsi que les clés des organisations que vous possédez. Une clé créée pour une organisation est décomptée du forfait de son propriétaire. Une fois la limite atteinte, la création d'une clé est refusée avec un message indiquant la limite de votre forfait; désactivez ou supprimez alors une clé inutilisée, ou passez au forfait supérieur.

Révéler une clé

Cliquez sur l'icône en forme d'œil à côté du préfixe masqué d'une clé pour afficher à nouveau son secret complet. Le tableau de bord vous demande de confirmer, puis ouvre une boîte de dialogue avec la clé en clair, un bouton de copie et un court compte à rebours. Une fois le compte à rebours terminé, la boîte de dialogue efface le secret de la page.

Chaque révélation est consignée dans le journal d'audit, car elle expose un identifiant actif.

Toute personne avec qui la clé est partagée peut la révéler : son propriétaire personnel ou tout membre de l'organisation à laquelle elle appartient.

Clés héritées

Les clés créées avant le lancement de la fonctionnalité d'affichage affichent une icône de cadenas au lieu de l'œil et ne peuvent pas être révélées. Seul leur hash a été stocké, le secret d'origine est donc irrécupérable. Pour convertir une clé héritée, ouvrez le menu d'actions et sélectionnez Regenerate. Le nouveau secret sera ensuite affichable.

Autorisations par rôle

Sur une clé personnelle, vous pouvez tout faire. Sur une clé d'organisation, trois niveaux s'appliquent :

Action Membre Admin Propriétaire
Utiliser la clé et la révéler Oui Oui Oui
La renommer, modifier la description Oui Oui Oui
L'activer ou la désactiver Non Oui Oui
Régénérer le secret Non Oui Oui
La supprimer Non Oui Oui
La transférer hors de l'organisation Non Non Oui

Désactiver et Modifier restent visibles sur la ligne mais sont grisés avec une note explicative. Regenerate, Transfer et Delete n'apparaissent pas dans le menu lorsque votre rôle ne permet pas de les utiliser. L'API refuse les mêmes actions, une intégration ne peut donc pas contourner l'interface.

Cette répartition suit l'impact de chaque action sur les personnes partageant la clé. Renommer est sans risque. Régénérer ou désactiver interrompt l'intégration de chaque collègue à la seconde où cela se produit. Retirer une clé de l'organisation la soustrait à l'entreprise et impute son utilisation au forfait de celui qui la reprend, cette action est donc réservée au propriétaire.

Modifier une clé

Cliquez sur Edit pour modifier le nom et la description. La propriété n'est pas modifiée dans cette boîte de dialogue : utilisez Transfer.

View Metrics dans le menu d'actions ouvre la vue Overview filtrée sur cette clé.

Activation et désactivation

Utilisez Disable ou Enable sur la ligne. Désactiver une clé bloque chaque requête API qui l'utilise, et vous pouvez la réactiver à tout moment. Le changement prend effet en moins d'une minute.

Régénérer une clé

Si vous soupçonnez qu'une clé a été compromise, ouvrez le menu d'actions et sélectionnez Regenerate. Cette action crée un nouveau secret pour le même identifiant de clé. L'ancien secret cesse de fonctionner en moins d'une minute. Le nom, le propriétaire et tous les autres paramètres restent inchangés.

Le nouveau secret reste affichable après la fermeture de la boîte de dialogue, vous n'avez donc pas besoin de le copier immédiatement.

Transférer une clé

Transfer dans le menu d'actions déplace une clé entre un compte personnel et une organisation sans régénérer le secret. L'identifiant de la clé, ses métriques et son historique d'activité sont conservés. Seul le propriétaire change, et avec lui le compte auquel l'utilisation est facturée.

Déplacement Autorisé à
Clé personnelle vers une organisation Tout membre de cette organisation
Clé d'organisation vers soi-même Le propriétaire de l'organisation
Entre deux organisations Le propriétaire de l'organisation d'origine

Une clé transférée vers une organisation rejoint automatiquement l'équipe par défaut "Everyone", ce qui la rend visible aux membres. Une clé retirée de l'organisation quitte toutes les équipes dont elle faisait partie.

Supprimer une clé

Ouvrez le menu d'actions et sélectionnez Supprimer. La suppression d'une clé déjà utilisée la désactive : la clé cesse d'authentifier et reste dans la liste avec le statut Inactif, afin que l'historique d'Activité et de Métriques conserve son nom. Les clés qui n'ont jamais été utilisées sont supprimées définitivement.

Vous recevrez un e-mail lorsqu'une clé est supprimée.

Clés d'organisation et facturation

L'utilisation d'une clé appartenant à une organisation est décomptée du forfait du propriétaire de l'organisation, quel que soit l'auteur de la requête. La page Usage & Limits du propriétaire comptabilise ces clés aux côtés de ses clés personnelles et sépare les deux.

Mis à jour : 5 novembre 2026