Respuesta · Autenticación · Claves

Rotar o revocar una clave API

Actualizado el 9 de noviembre de 2026 · PinnFeed · 2 min de lectura

Respuesta: en el panel, crea una clave nueva, despliégala y luego revoca la antigua. Una clave revocada recibe 401 invalid_key en REST y en conexiones WebSocket nuevas, y cualquier WebSocket abierto con ella se cierra con el código 4001 key_revoked. Los planes de pago admiten hasta 20 claves activas, así que la rotación sin cortes es sencilla. Free tiene una clave activa: revócala primero y crea la nueva después.

Rotación sin cortes (planes de pago)#

Panel → Crear clave, con un nombre (por ejemplo bot-2026-11). El valor completo ps_live_... se muestra una sola vez; PinnFeed guarda solo un hash y los 12 primeros caracteres.
Pon la clave nueva en tu gestor de secretos o en la variable PINNFEED_KEY y vuelve a desplegar.
Comprueba en el panel que el último uso de la clave antigua deja de moverse.
Revoca la antigua. Cualquier cliente que siga con ella recibe 4001 (WebSocket) o 401 (REST).

Gestionar 4001 en el código#

ws.on('close', (code, reason) => {
  if (code === 4001) {
    console.error('key revoked: load the new PINNFEED_KEY before reconnecting');
    return;                        // do not reconnect in a loop with a dead key
  }
  scheduleReconnect();
});

Buenas prácticas#

Una clave por app o entorno: si se filtra, solo revocas una.
Nunca pongas una clave en código de navegador o móvil; usa un backend propio.
Prefiere la cabecera x-api-key a ?key=: las URL acaban en los logs.

Básicos: autenticación · códigos de error.

Planes#

Free: una clave activa, REST, 30 s de retraso. Planes de pago: hasta 20 claves activas. Builder (€99/mes) añade el WebSocket. Prueba de 3 días; se requiere tarjeta y se cobra después del día 3 salvo que canceles.

Contenido educativo para mayores de 18 años.

Preguntas frecuentes#

¿Puedo volver a ver una clave?#

No. Solo se guarda el prefijo; crea otra si la perdiste.

¿Las claves comparten límites?#

El límite REST se aplica por clave; los límites de conexiones WebSocket cuentan para toda la cuenta.

¿Puedo renombrar una clave?#

Sí, desde el panel; renombrar no cambia su valor.