Skip to main content
DELETE
Revoca permanentemente una clave de la API de gestión. Al igual que crear un token, este endpoint reside en el host habitual de la API de Scanova (qcg-api.scanova.io) y se autentica con tu token de acceso OAuth normal del panel — no con la clave que estás eliminando.

​
Solicitud

​
string
requerido
El valor completo de la clave devuelto cuando se creó el token (no un ID numérico).

​
Comportamiento

  • Una eliminación exitosa devuelve 204 No Content con un cuerpo vacío.
  • Una vez eliminada, la clave deja de autenticarse en el host de datos de inmediato — cualquier solicitud en curso o posterior que la use recibirá 401.
  • Solo puedes eliminar una clave que te pertenezca (o, en el caso de un usuario compartido, una clave que ese usuario compartido haya creado).
La eliminación también vuelve a verificar la cuota del plan usando un valor de environment, con sandbox como valor predeterminado si no pasas uno — la misma regla descrita en la página de crear token. Esto rara vez importa en la práctica, ya que los planes que otorgan acceso a la API de gestión normalmente lo otorgan en todos los entornos, pero pasa ?environment=live explícitamente si obtienes un 401 inesperado al eliminar una clave del entorno live.
No existe un estado de “deshabilitar” o “pausar” — la eliminación es inmediata y permanente. Si solo necesitas dejar de usar una clave temporalmente, no la elimines; crea una nueva clave y deja de usar la antigua, o coordínalo con la integración que la consume antes de eliminarla.

​
Relacionado

Autorizaciones

​
Authorization
string
header
requerido

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.

Parámetros de ruta

​
key
string
requerido

Respuesta

204

Token removed