Pogreške

Kada API zahtjev ne uspije, badges.ninja vraća JSON odgovor s pogreškom i odgovarajućim HTTP statusnim kodom.

Format pogreške

Sve pogreške imaju ovu strukturu:

{
  "error": "description of what went wrong"
}

Statusni kodovi

Kod	Značenje	Kada se događa
400	Bad Request	Nedostaju ili su neispravni parametri, dosegnuto je ograničenje plana ili kvota, značajka zahtijeva viši plan ili nemate ovlasti — svi neuspjesi validacije vraćaju 400
402	Payment Required	Rezervirano za iscrpljene kredite. Badges API trenutačno ne oduzima kredite, pa se ovaj kod u praksi nikada ne vraća
404	Not Found	Traženi resurs ne postoji
500	Internal Server Error	Na poslužitelju je došlo do neočekivane pogreške

Ne postoje 403 ni 429: neuspjeh autorizacije vraća 400 ("not authorized"), a ne postoji ni ograničavanje broja zahtjeva na razini aplikacije.

Česte pogreške i rješenja

Nedostaju obavezni parametri

{ "error": "missing required parameters: name, url, email" }

Rješenje: Uključite sve obavezne parametre u tijelo zahtjeva. Potpuni popis potražite u dokumentaciji endpointa.

Neispravan e-mail

{ "error": "invalid email" }

Rješenje: Navedite ispravnu e-mail adresu u formatu user@domain.com.

Neispravan URL

{ "error": "invalid URL" }

Rješenje: Navedite puni URL zajedno s protokolom, npr. https://example.com.

Prekratak naziv

{ "error": "name must be at least 3 characters" }

Rješenje: Koristite dulji naziv. Nazivi izdavatelja moraju imati najmanje 3 znaka. Imena primatelja moraju imati najmanje 5 znakova.

Izdavatelj nije provjeren

{ "error": "issuer must be verified before creating badges" }

Rješenje: Prvo provjerite izdavatelja. Potražite poveznicu za provjeru u e-mailu izdavatelja ili upotrijebite endpoint Provjera izdavatelja.

Dosegnuta kvota vjerodajnica (400)

{ "error": "Your Free plan reached its credential limit (1200/1200) — your allowance renews on your plan anniversary, or upgrade to Starter" }

Rješenje: Iskoristili ste cijeli godišnji fond vjerodajnica (Free: 1.200/godišnje, Starter: 12.000/godišnje, Pro: 120.000/godišnje). Fond se resetira na godišnjicu registracije vašeg računa — a ne na granici kalendarskog mjeseca. Nadogradite plan za veću kvotu. Pogledajte Planovi i naplata.

Dosegnuto ograničenje plana (400)

{ "error": "Your Free plan reached its issuer limit (2/2) — delete an issuer or upgrade to Starter" }

Ograničenje broja bedževa ima isti oblik:

{ "error": "badge limit reached (5/5 on the starter plan) — delete a badge or upgrade your plan" }

Rješenje: Dosegnuli ste gornju granicu svog plana za izdavatelje ili bedževe. Obrišite neiskorišteni resurs ili nadogradite plan.

Resurs ima ovisnosti (400)

{ "error": "issuer has 3 badge(s) linked — delete the badges first" }

Rješenje: Prije brisanja izdavatelja obrišite sve bedževe povezane s njim. Isto tako, prije brisanja bedža obrišite sve vjerodajnice pod tim bedžem.

Nemate ovlasti (400)

{ "error": "not authorized" }

Neuspjesi autorizacije su pogreške validacije, pa vraćaju 400 (a ne 401 ili 403).

Rješenje: Možete mijenjati samo resurse koje posjedujete. Provjerite koristite li ispravan API ključ.

HTML u tekstu za dijeljenje

{ "error": "HTML tags are not allowed" }

Rješenje: Tekst za dijeljenje mora biti običan tekst. Uklonite sve HTML oznake iz parametra text.