Errors

Quan una crida a l'API falla, badges.ninja retorna una resposta JSON d'error amb el codi HTTP corresponent.

Format d'error

Tots els errors segueixen aquesta estructura:

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

Codis d'estat

Codi	Significat	Quan passa
400	Bad Request	Paràmetres absents o invàlids
402	Payment Required	Bossa mensual d'atorgaments esgotada o funció que requereix un pla superior
403	Forbidden	Límit de pla assolit (p. ex. sostre d'emissors o de credencials)
404	Not Found	El recurs sol·licitat no existeix
429	Too Many Requests	Límit de freqüència superat
500	Internal Server Error	S'ha produït un error inesperat al servidor

Errors freqüents i solucions

Falten paràmetres obligatoris

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

Solució: Inclou tots els paràmetres obligatoris al cos de la sol·licitud. Consulta la documentació de l'endpoint per a la llista completa.

Correu invàlid

{ "error": "invalid email" }

Solució: Proporciona un correu amb format vàlid com user@domain.com.

URL invàlida

{ "error": "invalid URL" }

Solució: Proporciona una URL completa que inclogui el protocol, p. ex. https://example.com.

Nom massa curt

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

Solució: Fes servir un nom més llarg. Els noms d'emissor requereixen almenys 3 caràcters. Els noms de destinatari requereixen almenys 5 caràcters.

Emissor no verificat

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

Solució: Verifica primer l'emissor. Revisa el seu correu per a l'enllaç de verificació, o fes servir l'endpoint Verify Issuer.

Bossa mensual esgotada

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

Solució: Has esgotat els atorgaments inclosos al teu pla per a aquest període (Free: 100/mes, Starter: 1.000/mes, Pro: 10.000/mes). Espera el pròxim reinici o puja de pla. Consulta Plans i facturació.

Límit de pla assolit

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

Solució: Has tocat el sostre d'emissors, credencials o claus API del teu pla. Suprimeix algun recurs no emprat o puja de pla.

Blockchain requereix Pro

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

Solució: El paràmetre blockchain només està disponible al pla Pro. Puja de pla per activar la verificació on-chain.

Blockchain no compatible

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

Solució: De moment només s'admet matchain com a valor del paràmetre blockchain.

Recurs amb dependències

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

Solució: Suprimeix totes les credencials de l'emissor abans d'eliminar-lo. Igualment, suprimeix tots els atorgaments d'una credencial abans de suprimir-la.

No autoritzat

{ "error": "not authorized" }

Solució: Només pots modificar recursos que t'hagin estat assignats. Assegura't de fer servir la clau API correcta.

HTML al text de difusió

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

Solució: El text de difusió ha de ser text pla. Treu qualsevol etiqueta HTML del paràmetre de text.