Referencia · Panel

Revocar (repetible)

POST /api/configuracion/api-externa/credenciales/{id}/revocar

POST/api/configuracion/api-externa/credenciales/{id}/revocar

Autenticación: sesión del panel de Turnova (dueña o administradora). No se llama con una clave de la API.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
`id`	path	string	Sí

Ejemplo

// Desde el panel de Turnova, con la sesión iniciada (cookie).
const res = await fetch("/api/configuracion/api-externa/credenciales/cmh4k2n9x0001/revocar", {
  method: "POST",
});
const r = await res.json();

Respuestas

HTTP	Qué significa
200	Revocada (o ya lo estaba, `operacion.repetida`)
401	Clave faltante, inválida o revocada.
403	Origen no permitido, permiso faltante, clave secreta desde un navegador o plan sin la API (`PLAN_SIN_API`).
404	No existe o no es de este negocio.

Respuesta 200

{
  "ok": true,
  "operacion": {
    "referencia": "cmh4k2n9x0001",
    "repetida": false
  },
  "datos": {
    "credencial": {
      "id": "cmh4k2n9x0001",
      "nombre": "Masaje descontracturante",
      "tipo": "PUBLICA",
      "prefijo": "tnv_pk_ab12cd34",
      "scopes": [
        "catalogo:leer",
        "disponibilidad:leer",
        "reservas:crear"
      ],
      "origenes": [
        "https://mi-spa.com"
      ],
      "createdAt": "2026-11-01T13:00:00.000Z",
      "ultimoUsoEn": "2026-11-01T13:05:00.000Z",
      "revocadaEn": null
    }
  }
}

Campo	Tipo	Obligatorio
`datos.credencial`	object	No
`datos.credencial.id`	string	No
`datos.credencial.nombre`	string	No
`datos.credencial.tipo`	`PUBLICA`, `SECRETA`	No
`datos.credencial.prefijo`	string	No
`datos.credencial.scopes`	array de string	No
`datos.credencial.origenes`	array de string	No
`datos.credencial.createdAt`	string (date-time)	No
`datos.credencial.ultimoUsoEn`	string (date-time) o null	No
`datos.credencial.revocadaEn`	string (date-time) o null	No

Los errores siguen el formato común: ver Errores.