Réponse · Auth · Clés

Faire tourner ou révoquer une clé API

Mis à jour le 10 novembre 2026 · PinnFeed · 2 min de lecture

Réponse : dans le tableau de bord, créez une nouvelle clé, déployez-la, puis révoquez l'ancienne. Une clé révoquée reçoit 401 invalid_key en REST et sur les nouvelles connexions WebSocket, et tout WebSocket ouvert avec elle est fermé avec le code 4001 key_revoked. Les plans payants acceptent jusqu'à 20 clés actives, ce qui facilite une rotation sans coupure. Free n'a qu'une clé active : révoquez-la d'abord, puis créez la suivante.

Rotation sans coupure (plans payants)#

Tableau de bord → Créer une clé, avec un nom (par ex. bot-2026-11). La valeur complète ps_live_... s'affiche une seule fois ; PinnFeed ne stocke qu'un hash et les 12 premiers caractères.
Placez la nouvelle clé dans votre coffre ou dans PINNFEED_KEY et redéployez.
Vérifiez que le dernier usage de l'ancienne clé cesse de bouger.
Révoquez l'ancienne. Tout client encore dessus reçoit 4001 (WebSocket) ou 401 (REST).

Gérer 4001 dans le code#

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

Bonnes pratiques#

Une clé par app ou environnement : une fuite ne force à en révoquer qu'une.
Ne mettez jamais une clé dans du code navigateur ou mobile ; passez par un backend.
Préférez l'en-tête x-api-key à ?key= : les URL finissent dans les logs.

Bases : authentification · codes d'erreur.

Offres#

Free : une clé active, REST, 30 s de retard. Plans payants : jusqu'à 20 clés actives. Builder (99 €/mois) ajoute le WebSocket. Essai de 3 jours ; carte requise, débitée après le jour 3 sauf résiliation.

Contenu éducatif pour adultes (18+) : ni pronostics ni promesse de gain. En France, seuls les opérateurs agréés par l'ANJ peuvent proposer des paris en ligne.

Questions fréquentes#

Puis-je revoir une clé après création ?#

Non. Seul le préfixe est conservé ; créez-en une nouvelle si vous l'avez perdue.

Les clés partagent-elles les limites ?#

La limite REST s'applique par clé ; les plafonds de connexions WebSocket comptent pour tout le compte.

Puis-je renommer une clé ?#

Oui, depuis le tableau de bord ; renommer ne change pas la valeur.