API ključevi

API ključevi vam omogućuju programski pristup REST API-ju badges.ninja. Koristite ih za automatizaciju stvaranja, dodjeljivanja i upravljanja bedževima iz vlastitih aplikacija.

Stvaranje API ključa

1. U bočnoj traci otvorite stranicu API ključevi.
2. Kliknite Stvori API ključ. Otvara se ugrađeni obrazac:

3. Imenujte ključ i kliknite Stvori. Cijeli ključ prikazuje se samo jednom na zelenoj traci:

4. Ključ odmah kopirajte — prikazuje se samo jednom. Ako ga izgubite, morat ćete stvoriti novi. Nakon zatvaranja trake pohranjuje se samo prefiks:

Format ključa

API ključevi koriste prefiks bws_ praćen 32-znakovnim heksadecimalnim nizom:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Korištenje API ključeva u zahtjevima

Uključite API ključ u zaglavlje X-Api-Key svakog API zahtjeva:

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

Za sve pojedinosti o autentifikaciji API-ja pogledajte stranicu Autentifikacija.

Ograničenja ključeva po planu

Broj API ključeva koje možete stvoriti ovisi o vašem planu:

Plan	Ograničenje API ključeva
Free	1
Starter ($9/mj)	5
Pro ($29/mj)	20

Brisanje ključa

1. Otvorite stranicu API ključevi.
2. Pronađite ključ koji želite obrisati.
3. Kliknite Obriši.
4. Potvrdite brisanje.

Nakon brisanja ključ odmah prestaje raditi. Sve aplikacije koje koriste taj ključ primit će pogreške autentifikacije.