Pogreške

Kad API zahtjev ne uspije, badges.ninja vraća JSON odgovor s odgovarajućim HTTP statusnim kodom.

Format pogreške

Sve pogreške slijede ovu strukturu:

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

Statusni kodovi

Kod	Značenje	Kada se događa
400	Bad Request	Nedostajući ili nevažeći parametri
402	Payment Required	Mjesečna kvota dodjela dosegnuta ili značajka zahtijeva viši plan
403	Forbidden	Dosegnuto ograničenje plana (npr. ograničenje izdavatelja ili bedževa)
404	Not Found	Traženi resurs ne postoji
429	Too Many Requests	Ograničenje brzine premašeno
500	Internal Server Error	Na poslužitelju je došlo do neočekivane pogreške

Česte pogreške i rješenja

Nedostajući obvezni parametri

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

Rješenje: Uključite sve obvezne parametre u tijelo zahtjeva. Provjerite dokumentaciju endpointa za potpuni popis.

Nevažeća e-pošta

{ "error": "invalid email" }

Rješenje: Pružite valjanu adresu e-pošte u formatu user@domain.com.

Nevažeći URL

{ "error": "invalid URL" }

Rješenje: Pružite potpuni URL uključujući protokol, npr. https://example.com.

Naziv prekratak

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

Rješenje: Koristite duži naziv. Nazivi izdavatelja zahtijevaju najmanje 3 znaka. Imena primatelja zahtijevaju najmanje 5 znakova.

Izdavatelj nije provjeren

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

Rješenje: Prvo provjerite izdavatelja. Provjerite e-poštu izdavatelja za poveznicu provjere ili koristite endpoint Verify Issuer.

Mjesečna kvota dodjela dosegnuta

{ "error": "monthly award quota reached" }

Rješenje: Iskoristili ste sve dodjele uključene u vaš plan za ovo obračunsko razdoblje (Free: 100/mj, Starter: 1.000/mj, Pro: 10.000/mj). Pričekajte sljedeće resetiranje ili nadogradite svoj plan. Pogledajte Planovi i naplata.

Ograničenje plana dosegnuto

{ "error": "issuer limit reached for your plan" }

Rješenje: Dosegli ste ograničenje vašeg plana za izdavatelje, bedževe ili API ključeve. Obrišite neiskorišteni resurs ili nadogradite svoj plan.

Blockchain zahtijeva Pro

{ "error": "blockchain verification requires the Pro plan" }

Rješenje: Parametar blockchain dostupan je samo u planu Pro. Nadogradite za omogućavanje on-chain provjere.

Nepodržan blockchain

{ "error": "unsupported blockchain, only 'matchain' is supported" }

Rješenje: Trenutno je kao parametar blockchaina podržan samo matchain.

Resurs ima ovisnosti

{ "error": "issuer has badges and cannot be deleted" }

Rješenje: Prije brisanja izdavatelja obrišite sve bedževe pod njim. Slično, prije brisanja bedža obrišite sve dodjele pod njim.

Bez autorizacije

{ "error": "not authorized" }

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

HTML u tekstu dijeljenja

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

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