Feil

Når en API-forespørsel mislykkes, returnerer badges.ninja et JSON-feilsvar med en passende HTTP-statuskode.

Feilformat

Alle feil følger denne strukturen:

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

Statuskoder

Kode	Betydning	Når det skjer
400	Bad Request	Manglende eller ugyldige parametere
402	Payment Required	Månedlig tildelingskvote nådd, eller funksjon krever en høyere plan
403	Forbidden	Plan-grense nådd (f.eks. utsteder- eller merketak)
404	Not Found	Den forespurte ressursen finnes ikke
429	Too Many Requests	Hastighetsgrense overskredet
500	Internal Server Error	En uventet feil oppsto på serveren

Vanlige feil og løsninger

Manglende påkrevde parametere

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

Løsning: Inkluder alle påkrevde parametere i forespørselens body. Sjekk endepunktdokumentasjonen for den fulle listen.

Ugyldig e-post

{ "error": "invalid email" }

Løsning: Oppgi en gyldig e-postadresse i formatet user@domain.com.

Ugyldig URL

{ "error": "invalid URL" }

Løsning: Oppgi en full URL inkludert protokollen, f.eks. https://example.com.

Navnet er for kort

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

Løsning: Bruk et lengre navn. Utstedernavn krever minst 3 tegn. Mottakernavn krever minst 5 tegn.

Utsteder ikke verifisert

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

Løsning: Verifiser utstederen først. Sjekk utstederens e-post for verifiseringslenken, eller bruk endepunktet Verifiser utsteder.

Månedlig tildelingskvote nådd

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

Løsning: Du har brukt alle tildelinger inkludert i planen din for denne faktureringsperioden (Free: 100/md, Starter: 1 000/md, Pro: 10 000/md). Vent på neste nullstilling, eller oppgrader planen. Se Planer & Fakturering.

Plan-grense nådd

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

Løsning: Du har nådd planens tak for utstedere, merker eller API-nøkler. Slett en ubrukt ressurs, eller oppgrader planen.

Blockchain krever Pro

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

Løsning: Parameteren blockchain er kun tilgjengelig i Pro-planen. Oppgrader for å aktivere on-chain-verifisering.

Ikke-støttet blockchain

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

Løsning: For øyeblikket støttes kun matchain som blockchain-parameter.

Ressurs har avhengigheter

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

Løsning: Slett alle merker under utstederen før du sletter utstederen. På samme måte sletter du alle tildelinger under et merke før du sletter merket.

Ikke autorisert

{ "error": "not authorized" }

Løsning: Du kan bare endre ressurser du eier. Pass på at du bruker riktig API-nøkkel.

HTML i delingstekst

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

Løsning: Delingstekst må være vanlig tekst. Fjern eventuelle HTML-tagger fra tekst-parameteren.