Skip to main content
Cette page couvre l’interface du tableau de bord pour les clés Management API. Pour le format technique sous-jacent, consultez les pages de référence techniques : Create an API token, Remove an API token, et les usage endpoints.

​
Où la trouver

Les clés API se trouvent à /api/keys, sous Developer → API dans la barre latérale. C’est la même page que vous ayez zéro clé ou plusieurs — un compte vide affiche un texte explicatif au lieu d’un tableau vide :
Page API Keys affichant l'en-tête « API Keys » avec un bouton Generate API Key, une note indiquant « You can create upto 1 API keys », et un panneau d'état vide intitulé « Run Scanova from your own systems » avec trois cartes d'avantages (Full programmatic control, Integrate with your own systems, Automate at scale) et un bouton Generate API Key

Page API Keys, vérifiée en direct sur un compte sans clé encore — notez la note de quota du plan directement sous l'en-tête de page

L’accès à cette page est conditionné par deux éléments : une permission (view ou manage) et un quota de plan (MANAGEMENT_API). Si votre plan n’accorde pas ce quota, vous ne verrez pas du tout cette page — contactez le support si vous attendez un accès Management API sur votre plan.

​
Générer une clé

Sélectionnez Generate API Key (dans l’en-tête, ou le bouton propre de l’état vide) pour ouvrir le panneau de création :
Panneau Create API Key avec un champ de texte Name (0/100 caractères) et un menu déroulant Expiration réglé sur « in 1 Month », avec des boutons Cancel et Create

Le panneau Create API Key, vérifié en direct

Sélectionner Create affiche immédiatement la valeur brute de la clé dans une boîte de dialogue à usage unique :
La boîte de dialogue de clé créée indique « Copy your API key now. You won’t be able to see it again. » Copiez-la immédiatement — ce projet de documentation n’a pas publié de capture d’écran de cette boîte de dialogue, puisqu’elle affiche nécessairement un secret réel, en direct et copiable.
Si vous choisissez Never comme expiration, la boîte de dialogue affiche un avertissement ambre supplémentaire indiquant qu’une clé configurée pour ne jamais expirer doit être traitée avec une prudence accrue, puisqu’elle ne sera pas renouvelée automatiquement.

​
Gérer les clés existantes

Le tableau liste toutes les clés du compte : Name, une valeur API Key masquée avec une icône de copie dans le presse-papiers, Created On, Created By, et Expires On (ou « Never »). La date d’une clé expirée s’affiche en rouge.
Le plan de ce compte n’autorise qu’1 clé API à la fois — la note directement sous l’en-tête de page (« You can create upto {limit} API keys ») reflète le quota de votre plan spécifique, pas une limite valable pour toute la plateforme. Si vous êtes sur un plan illimité, cette note n’apparaît pas du tout.

​
Révoquer une clé

Sélectionnez l’icône de corbeille à la fin de la ligne d’une clé pour ouvrir un panneau de confirmation affichant le nom de la clé, sa valeur masquée, son badge Active/Expired, et sa date de création. Confirmer la révoque immédiatement et de façon permanente — correspondant exactement au comportement du remove endpoint : il n’y a pas d’état « pause », et toute requête déjà en cours avec cette clé commence à échouer immédiatement.

​
Voir aussi

  • Create an API token — la forme technique de requête/réponse derrière le panneau Generate API Key ci-dessus.
  • Remove an API token — la forme technique derrière l’action de révocation ci-dessus.
  • API usage dashboard — où (et actuellement, où pas) vous pouvez voir combien une clé a été utilisée.