v2

latestOpenAPI 3.0.3CC-BY-4.02026-07-262256119.8 KB

Cuenta

Rotar o revocar tu propia API key

Permite al titular de una clave rotarla (genera una clave nueva; la anterior deja de funcionar de inmediato) o revocarla (desactivación inmediata) sin pasar por soporte. Autenticación por posesión: se valida la cabecera X-API-Key con la clave ACTUAL — no se admite ninguna otra credencial ni sesión. Disponible para cualquier plan. La clave nueva devuelta en rotate solo se muestra una vez en la respuesta: no se reenvía por email ni se registra en logs. Límite de 30 peticiones/hora por IP.

post/keys

Request body

action'rotate' | 'revoke' required

Acción a realizar: rotate (genera una clave nueva) o revoke (desactiva la clave actual).

Example request

{
  "action": "rotate"
}

Response

Acción aplicada correctamente

successboolean

api_keystring

Presente solo cuando action=rotate. Clave nueva completa, se devuelve una única vez.

messagestring

Example response

{
  "success": true,
  "api_key": "cvr_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4",
  "message": "Clave rotada. Guárdala: no se vuelve a mostrar."
}