Chyby

Když požadavek API selže, badges.ninja vrací JSON odpověď s chybou a vhodným HTTP status kódem.

Formát chyby

Všechny chyby mají následující strukturu:

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

Status kódy

Kód	Význam	Kdy nastává
400	Bad Request	Chybějící nebo neplatné parametry
402	Payment Required	Dosažen měsíční limit udělení nebo funkce vyžaduje vyšší plán
403	Forbidden	Dosažen limit plánu (např. počet vydavatelů nebo odznaků)
404	Not Found	Požadovaný zdroj neexistuje
429	Too Many Requests	Překročen limit rychlosti
500	Internal Server Error	Neočekávaná chyba na straně serveru

Časté chyby a jejich řešení

Chybějící povinné parametry

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

Řešení: Zahrňte všechny povinné parametry do těla požadavku. Zkontrolujte dokumentaci endpointu pro celý seznam.

Neplatný e-mail

{ "error": "invalid email" }

Řešení: Poskytněte platnou e-mailovou adresu ve formátu user@domain.com.

Neplatná URL

{ "error": "invalid URL" }

Řešení: Poskytněte plnou URL včetně protokolu, např. https://example.com.

Příliš krátký název

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

Řešení: Použijte delší název. Názvy vydavatelů vyžadují alespoň 3 znaky. Jména příjemců vyžadují alespoň 5 znaků.

Vydavatel není ověřen

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

Řešení: Nejprve ověřte vydavatele. Zkontrolujte e-mail vydavatele kvůli ověřovacímu odkazu nebo použijte endpoint Ověřit vydavatele.

Dosažen měsíční limit udělení

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

Řešení: Vyčerpali jste všechna udělení obsažená ve vašem plánu pro toto zúčtovací období (Free: 100/měs, Starter: 1 000/měs, Pro: 10 000/měs). Počkejte na další reset nebo upgradujte svůj plán. Viz Plány a platby.

Dosažen limit plánu

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

Řešení: Dosáhli jste limitu vašeho plánu na vydavatele, odznaky nebo klíče API. Smažte nepoužívaný zdroj nebo upgradujte svůj plán.

Blockchain vyžaduje plán Pro

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

Řešení: Parametr blockchain je dostupný pouze v plánu Pro. Upgradujte, abyste zapnuli on-chain ověření.

Nepodporovaný blockchain

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

Řešení: Aktuálně je jako parametr blockchain podporován pouze matchain.

Zdroj má závislosti

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

Řešení: Před smazáním vydavatele smažte všechny odznaky pod ním. Podobně před smazáním odznaku smažte všechna udělení pod ním.

Bez oprávnění

{ "error": "not authorized" }

Řešení: Můžete upravovat pouze zdroje, které vlastníte. Ujistěte se, že používáte správný klíč API.

HTML v textu sdílení

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

Řešení: Text sdílení musí být prostý text. Odstraňte všechny HTML tagy z parametru text.