Skip to main content
DELETE
Révoque définitivement une clé Management API. Comme pour créer un token, cela se trouve sur l’hôte habituel de l’API Scanova (qcg-api.scanova.io) et est authentifié avec votre token d’accès OAuth habituel du tableau de bord — et non la clé que vous supprimez.

​
Requête

​
string
requis
La valeur complète de la clé renvoyée lors de la création du token (et non un ID numérique).

​
Comportement

  • Une suppression réussie renvoie 204 No Content avec un corps vide.
  • Une fois supprimée, la clé cesse immédiatement de s’authentifier sur l’hôte de données — toute requête en cours ou ultérieure l’utilisant reçoit une erreur 401.
  • Vous ne pouvez supprimer qu’une clé que vous possédez (ou, pour un utilisateur partagé, une clé que cet utilisateur partagé a créée).
La suppression revérifie également le quota de plan en utilisant une valeur environment, par défaut sandbox si vous n’en transmettez pas — la même règle décrite sur la page créer un token. Cela n’a rarement d’importance en pratique puisque les plans accordant l’accès à la Management API l’accordent généralement sur tous les environnements, mais transmettez explicitement ?environment=live si vous rencontrez une erreur 401 inattendue lors de la suppression d’une clé d’environnement live.
Il n’existe pas d’état « désactiver » ou « mettre en pause » — la suppression est immédiate et permanente. Si vous avez simplement besoin d’arrêter temporairement l’utilisation d’une clé, ne la supprimez pas ; créez une nouvelle clé et cessez d’utiliser l’ancienne, ou coordonnez-vous avec l’intégration qui la consomme avant de la supprimer.

​
Voir aussi

Autorisations

​
Authorization
string
header
requis

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

Paramètres de chemin

​
key
string
requis

Réponse

204

Token removed