Napake

Ko API zahteva spodleti, badges.ninja vrne odgovor JSON z ustrezno HTTP statusno kodo.

Oblika napake

Vse napake imajo to strukturo:

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

Statusne kode

Koda	Pomen	Kdaj se zgodi
400	Bad Request	Manjkajoči ali neveljavni parametri
402	Payment Required	Mesečna kvota podelitev dosežena ali funkcija zahteva višji paket
403	Forbidden	Dosežena omejitev paketa (npr. omejitev izdajateljev ali značk)
404	Not Found	Zahtevani vir ne obstaja
429	Too Many Requests	Omejitev hitrosti presežena
500	Internal Server Error	Na strežniku je prišlo do nepričakovane napake

Pogoste napake in rešitve

Manjkajoči obvezni parametri

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

Rešitev: V telo zahteve vključite vse obvezne parametre. Za celoten seznam preverite dokumentacijo endpointa.

Neveljavna e-pošta

{ "error": "invalid email" }

Rešitev: Posredujte veljaven e-poštni naslov v obliki user@domain.com.

Neveljaven URL

{ "error": "invalid URL" }

Rešitev: Posredujte celoten URL, vključno s protokolom, npr. https://example.com.

Ime prekratko

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

Rešitev: Uporabite daljše ime. Imena izdajateljev zahtevajo najmanj 3 znake. Imena prejemnikov zahtevajo najmanj 5 znakov.

Izdajatelj ni preveren

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

Rešitev: Najprej preverite izdajatelja. Preverite e-pošto izdajatelja za povezavo za preverjanje ali uporabite endpoint Verify Issuer.

Mesečna kvota podelitev dosežena

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

Rešitev: Porabili ste vse podelitve, vključene v vaš paket za to obračunsko obdobje (Free: 100/mes, Starter: 1.000/mes, Pro: 10.000/mes). Počakajte na naslednjo ponastavitev ali nadgradite svoj paket. Glej Paketi in obračun.

Omejitev paketa dosežena

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

Rešitev: Dosegli ste omejitev vašega paketa za izdajatelje, značke ali API ključe. Izbrišite neuporabljen vir ali nadgradite svoj paket.

Veriga blokov zahteva Pro

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

Rešitev: Parameter blockchain je na voljo le v paketu Pro. Nadgradite za omogočanje on-chain preverjanja.

Nepodprta veriga blokov

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

Rešitev: Trenutno je kot parameter verige blokov podprt le matchain.

Vir ima odvisnosti

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

Rešitev: Pred brisanjem izdajatelja izbrišite vse značke pod njim. Podobno pred brisanjem značke izbrišite vse podelitve pod njo.

Brez avtorizacije

{ "error": "not authorized" }

Rešitev: Spreminjate lahko le vire, ki jih posedujete. Prepričajte se, da uporabljate pravilen API ključ.

HTML v besedilu deljenja

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

Rešitev: Besedilo deljenja mora biti navadno besedilo. Odstranite vse HTML oznake iz parametra text.