Chyby

Keď API požiadavka zlyhá, badges.ninja vráti JSON odpoveď s príslušným HTTP stavovým kódom.

Formát chyby

Všetky chyby majú túto štruktúru:

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

Stavové kódy

Kód	Význam	Kedy sa stáva
400	Bad Request	Chýbajúce alebo neplatné parametre
402	Payment Required	Mesačná kvóta udelení dosiahnutá alebo funkcia vyžaduje vyšší plán
403	Forbidden	Dosiahnutý limit plánu (napr. limit vydavateľov alebo odznakov)
404	Not Found	Požadovaný zdroj neexistuje
429	Too Many Requests	Prekročený limit rýchlosti
500	Internal Server Error	Na serveri došlo k neočakávanej chybe

Bežné chyby a riešenia

Chýbajúce povinné parametre

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

Riešenie: Zahrňte všetky povinné parametre v tele požiadavky. Skontrolujte dokumentáciu endpointu pre úplný zoznam.

Neplatný e-mail

{ "error": "invalid email" }

Riešenie: Poskytnite platnú e-mailovú adresu vo formáte user@domain.com.

Neplatná URL

{ "error": "invalid URL" }

Riešenie: Poskytnite úplnú URL vrátane protokolu, napr. https://example.com.

Príliš krátky názov

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

Riešenie: Použite dlhší názov. Názvy vydavateľov vyžadujú aspoň 3 znaky. Mená príjemcov vyžadujú aspoň 5 znakov.

Vydavateľ nie je overený

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

Riešenie: Najprv overte vydavateľa. Skontrolujte e-mail vydavateľa pre overovací odkaz alebo použite endpoint Verify Issuer.

Mesačná kvóta udelení dosiahnutá

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

Riešenie: Vyčerpali ste všetky udelenia zahrnuté vo vašom pláne pre toto fakturačné obdobie (Free: 100/mes, Starter: 1 000/mes, Pro: 10 000/mes). Počkajte na ďalší reset alebo zvýšte svoj plán. Pozri Plány a fakturácia.

Limit plánu dosiahnutý

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

Riešenie: Dosiahli ste limit vášho plánu na vydavateľov, odznakov alebo API kľúčov. Odstráňte nepoužitý zdroj alebo zvýšte svoj plán.

Blockchain vyžaduje Pro

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

Riešenie: Parameter blockchain je dostupný iba v pláne Pro. Aktualizujte na povolenie on-chain overenia.

Nepodporovaný blockchain

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

Riešenie: Aktuálne je ako parameter blockchainu podporovaný iba matchain.

Zdroj má závislosti

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

Riešenie: Pred odstránením vydavateľa odstráňte všetky odznaky pod ním. Podobne pred odstránením odznaku odstráňte všetky udelenia pod ním.

Bez autorizácie

{ "error": "not authorized" }

Riešenie: Môžete upravovať iba zdroje, ktoré vlastníte. Uistite sa, že používate správny API kľúč.

HTML v texte zdieľania

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

Riešenie: Text zdieľania musí byť obyčajný text. Odstráňte všetky HTML značky z parametra text.