Skip to content

Chei API

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

Chei API — stare goală

Crearea unei chei API

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

Creare cheie — formular de nume

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

Cheie nou-creată afișată o singură dată

  1. 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:

Listă de chei cu prefixul mascat

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:

bash
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:

PlanLimită chei API
Free1
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.

Confirmare ștergere cheie — revocarea este imediată

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

badges.ninja Documentation