Risposta · Auth · Chiavi

Ruotare o revocare una chiave API

Aggiornato il 10 novembre 2026 · PinnFeed · 2 min di lettura

Risposta: nel dashboard, crea una nuova chiave, distribuiscila, poi revoca la vecchia. Una chiave revocata riceve 401 invalid_key su REST e su nuove connessioni WebSocket, e ogni WebSocket aperto con essa viene chiuso con codice 4001 key_revoked. I piani a pagamento ammettono fino a 20 chiavi attive, quindi la rotazione senza downtime è semplice. Free ha una sola chiave attiva: revocala prima, poi crea la nuova.

Rotazione senza downtime (piani a pagamento)#

Dashboard → Crea chiave, con un nome (es. bot-2026-11). Il valore completo ps_live_... viene mostrato una sola volta; PinnFeed conserva solo un hash e i primi 12 caratteri.
Metti la nuova chiave nel secret store o in PINNFEED_KEY e ridistribuisci.
Controlla che l'ultimo uso della vecchia chiave smetta di muoversi.
Revoca la vecchia. Qualsiasi client ancora su di essa riceve 4001 (WebSocket) o 401 (REST).

Gestire 4001 nel codice#

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();
});

Buone pratiche#

Una chiave per app o ambiente: una fuga ne fa revocare solo una.
Non mettere mai una chiave in codice browser o mobile.
Preferisci l'header x-api-key a ?key=: gli URL finiscono nei log.

Basi: autenticazione · codici di errore.

Piani#

Free: una chiave attiva, REST, 30 s di ritardo. Piani a pagamento: fino a 20 chiavi attive. Builder (99 €/mese) aggiunge il WebSocket. Prova di 3 giorni; carta richiesta, addebitata dopo il giorno 3 salvo disdetta.

Contenuto educativo per maggiorenni (18+): non pronostici né promesse di guadagno. In Italia scommetti solo con operatori autorizzati ADM.

Domande frequenti#

Posso rivedere una chiave dopo averla creata?#

No. Resta solo il prefisso; creane una nuova se l'hai persa.

Le chiavi condividono i limiti?#

Il limite REST vale per chiave; i tetti di connessioni WebSocket contano sull'intero account.

Posso rinominare una chiave?#

Sì, dal dashboard; rinominare non cambia il valore.