Chei API

Cheile API îți permit să accesezi REST API-ul badges.ninja în mod programatic. Folosește-le pentru a automatiza crearea, emiterea și gestionarea credențialelor din propriile aplicații.

Crearea unei chei API

1. Deschide secțiunea Chei API din bara laterală.
2. Apasă Creează cheie API. Apare un formular în linie:

3. Dă un nume cheii și apasă Creează. Cheia integrală este dezvăluită o singură dată într-un banner verde:

4. Copiază cheia imediat — este afișată o singură dată. Dacă o pierzi, va trebui să creezi alta. După închiderea banner-ului rămâne stocat doar prefixul:

Domenii de acces

Când creezi o cheie o poți face doar-citire sau o poți lăsa cu acces complet:

Domeniu	Permite
Acces complet (implicit)	Citire și scriere — listarea datelor și crearea, emiterea, actualizarea sau ștergerea.
Doar-citire	Doar solicitări GET sigure. Orice solicitare care modifică date (POST, PUT, PATCH, DELETE) este respinsă cu 403 Forbidden.

Folosește o cheie doar-citire pentru integrări care trebuie doar să citească datele tale (raportare, panouri, copii de rezervă), astfel încât o cheie compromisă să nu poată schimba nimic. Bifează Cheie doar-citire în formularul de creare; cheile doar-citire afișează o insignă Doar-citire în listă. Cheile create înainte de existența domeniilor păstrează accesul complet.

Formatul cheii

Cheile API utilizează prefixul bws_ urmat de un șir hexazecimal de 32 de caractere:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Utilizarea cheilor API în solicitări

Inserează cheia API în antetul X-Api-Key al fiecărei solicitări:

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

Consultă pagina Autentificare pentru detalii complete despre autentificarea API.

Limite de chei pe plan

Numărul de chei API pe care le poți crea depinde de planul tău:

Plan	Limită chei API
Free	1
Starter ($9/lună)	5
Pro ($29/lună)	20

Ștergerea unei chei

1. Deschide secțiunea Chei API.
2. Localizează cheia de eliminat.
3. Apasă Șterge.
4. Confirmă eliminarea.

După ștergere, cheia încetează să funcționeze imediat. Aplicațiile care o folosesc vor primi erori de autentificare.