Clés API

Les clés API vous permettent d'accéder à l'API REST de badges.ninja de manière programmatique. Utilisez-les pour automatiser la création, l'attribution et la gestion des badges depuis vos propres applications.

Créer une clé API

1. Ouvrez la page Clés API dans la barre latérale.
2. Cliquez sur Créer une clé API. Un formulaire en ligne s'ouvre :

3. Donnez un nom à la clé et cliquez sur Créer. La clé complète est affichée une seule fois dans un bandeau vert :

4. Copiez la clé immédiatement — elle n'est affichée qu'une seule fois. Si vous la perdez, vous devrez en créer une nouvelle. Une fois le bandeau fermé, seul le préfixe est conservé :

Format de la clé

Les clés API utilisent le préfixe bws_ suivi d'une chaîne hexadécimale de 32 caractères :

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Utiliser les clés API dans les requêtes

Incluez la clé API dans l'en-tête X-Api-Key de chaque requête :

curl -X GET https://api.badges.ninja/issuers \
  -H "X-Api-Key: bws_your_api_key_here"

Voir la page Authentification pour tous les détails sur l'authentification de l'API.

Limites de clés par forfait

Le nombre de clés API que vous pouvez créer dépend de votre forfait :

Forfait	Limite de clés API
Free	1
Starter (9 $/mois)	5
Pro (29 $/mois)	20

Supprimer une clé

1. Ouvrez la page Clés API.
2. Trouvez la clé à supprimer.
3. Cliquez sur Supprimer.
4. Confirmez la suppression.

Une fois supprimée, la clé cesse immédiatement de fonctionner. Toute application utilisant cette clé recevra des erreurs d'authentification.