Claves API

Las claves API te permiten acceder a la REST API de badges.ninja de forma programática. Úsalas para automatizar la creación, el otorgamiento y la gestión de insignias desde tus propias aplicaciones.

Crear una clave API

1. Abre la página Claves API desde la barra lateral.
2. Haz clic en Crear clave API. Se abre un formulario en línea:

3. Dale un nombre a la clave y haz clic en Crear. La clave completa se muestra una sola vez en un banner verde:

4. Copia la clave inmediatamente — solo se muestra una vez. Si la pierdes, tendrás que crear una nueva. Tras cerrar el banner, solo se almacena el prefijo:

Formato de la clave

Las claves API usan el prefijo bws_ seguido de una cadena hex de 32 caracteres:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Usar claves API en solicitudes

Incluye la clave API en la cabecera X-Api-Key de cada solicitud:

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

Consulta la página de Autenticación para todos los detalles sobre la autenticación en la API.

Límites de claves por plan

El número de claves API que puedes crear depende de tu plan:

Plan	Límite de claves API
Free	1
Starter (9 $/mes)	5
Pro (29 $/mes)	20

Eliminar una clave

1. Abre la página Claves API.
2. Busca la clave que quieres eliminar.
3. Haz clic en Eliminar.
4. Confirma la eliminación.

Una vez eliminada, la clave deja de funcionar inmediatamente. Cualquier aplicación que la use recibirá errores de autenticación.