Erori

Atunci când o cerere API eșuează, badges.ninja returnează un răspuns JSON de eroare cu codul HTTP corespunzător.

Formatul erorii

Toate erorile urmează această structură:

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

Coduri de stare

Cod	Semnificație	Când apare
400	Bad Request	Parametri lipsă sau nevalizi
402	Payment Required	Alocația lunară de acordări atinsă sau funcționalitate care necesită un plan superior
403	Forbidden	Limita planului atinsă (ex. plafonul de emitenți sau de credențiale)
404	Not Found	Resursa solicitată nu există
429	Too Many Requests	Limită de frecvență depășită
500	Internal Server Error	A apărut o eroare neașteptată pe server

Erori frecvente și soluții

Lipsesc parametri obligatorii

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

Soluție: Include toți parametrii obligatorii în corpul cererii. Consultă documentația endpoint-ului pentru lista completă.

E-mail nevalid

{ "error": "invalid email" }

Soluție: Furnizează o adresă de e-mail cu format corect, precum user@domain.com.

URL nevalid

{ "error": "invalid URL" }

Soluție: Furnizează un URL complet care include protocolul, ex. https://example.com.

Nume prea scurt

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

Soluție: Folosește un nume mai lung. Numele emitenților necesită cel puțin 3 caractere. Numele destinatarilor necesită cel puțin 5 caractere.

Emitent neverificat

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

Soluție: Verifică mai întâi emitentul. Consultă e-mailul său pentru linkul de verificare sau folosește endpoint-ul Verify Issuer.

Alocație lunară epuizată

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

Soluție: Ai epuizat acordările incluse în planul tău pentru această perioadă (Free: 100/lună, Starter: 1.000/lună, Pro: 10.000/lună). Așteaptă următoarea resetare sau fă upgrade la plan. Consultă Planuri și facturare.

Limita planului atinsă

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

Soluție: Ai atins plafonul de emitenți, credențiale sau chei API al planului. Șterge o resursă neutilizată sau fă upgrade.

Blockchain necesită Pro

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

Soluție: Parametrul blockchain este disponibil doar în planul Pro. Fă upgrade pentru a activa verificarea on-chain.

Blockchain neacceptat

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

Soluție: Momentan se acceptă doar matchain ca valoare pentru parametrul blockchain.

Resursă cu dependențe

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

Soluție: Șterge toate credențialele emitentului înainte de a-l elimina. Similar, șterge toate acordările unei credențiale înainte de a o suprima.

Neautorizat

{ "error": "not authorized" }

Soluție: Poți modifica doar resursele care îți aparțin. Asigură-te că folosești cheia API corectă.

HTML în textul de distribuire

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

Soluție: Textul de distribuire trebuie să fie text simplu. Scoate orice etichetă HTML din parametrul de text.