Claves API

Las claves API te dan acceso programático a la REST API de badges.ninja. Úsalas para automatizar la creación, el otorgamiento y la gestión de credenciales desde tus propias aplicaciones.

Crear una clave API

1. Abre la sección API Keys desde la barra lateral.
2. Pulsa Create API Key. Se despliega un formulario en línea:

3. Dale un nombre a la clave y pulsa Create. La clave íntegra aparece una sola vez en un banner verde:

4. Copia la clave de inmediato — solo se muestra una vez. Si la pierdes, tendrás que crear otra. Al cerrar el banner, solo queda guardado el prefijo:

Formato de la clave

Las claves API llevan el prefijo bws_ seguido de una cadena hexadecimal de 32 caracteres:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Usar claves API en tus 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 Autenticación para conocer los detalles completos de autenticación en la API.

Límites de claves por plan

La cantidad de claves API que puedes crear varía según tu plan:

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

Eliminar una clave

1. Abre la sección API Keys.
2. Localiza la clave que deseas suprimir.
3. Pulsa Delete.
4. Confirma la eliminación.

Tras eliminarla, la clave deja de funcionar al instante. Las aplicaciones que la usen recibirán errores de autenticación.