Chaves de API

As chaves de API permitem aceder à REST API do badges.ninja de forma programática. Utilize-as para automatizar a criação, a atribuição e a gestão de distintivos a partir das suas próprias aplicações.

Criar uma chave de API

1. Abra a página Chaves de API na barra lateral.
2. Clique em Criar chave de API. Abre-se um formulário em linha:

3. Atribua um nome à chave e clique em Criar. A chave completa é revelada apenas uma vez num banner verde:

4. Copie a chave imediatamente — é mostrada uma única vez. Se a perder, terá de criar uma nova. Após fechar o banner, fica guardado apenas o prefixo:

Formato das chaves

As chaves de API utilizam o prefixo bws_ seguido de uma cadeia hexadecimal de 32 caracteres:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Utilizar chaves de API nos pedidos

Inclua a chave de API no cabeçalho X-Api-Key em cada pedido feito à API:

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

Consulte a página Autenticação para mais detalhes sobre autenticação da API.

Limites de chaves por plano

O número de chaves de API que pode criar depende do seu plano:

Plano	Limite de chaves de API
Free	1
Starter ($9/mês)	5
Pro ($29/mês)	20

Eliminar uma chave

1. Abra a página Chaves de API.
2. Localize a chave que pretende eliminar.
3. Clique em Eliminar.
4. Confirme a eliminação.

Após ser eliminada, a chave deixa imediatamente de funcionar. Quaisquer aplicações que estejam a utilizá-la irão receber erros de autenticação.