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, plangrense eller kvote nådd, funksjonen krever en høyere plan, eller ikke autorisert — alle valideringsfeil returnerer 400
402	Payment Required	Reservert for oppbrukte kreditter. Badges-API-et trekker for øyeblikket ikke kreditter, så denne koden returneres aldri i praksis
404	Not Found	Den forespurte ressursen finnes ikke
500	Internal Server Error	Det oppstod en uventet feil på serveren

Det finnes ingen 403 eller 429: autorisasjonsfeil returnerer 400 ("not authorized"), og det er ingen ratebegrensning på applikasjonslaget.

Vanlige feil og løsninger

Manglende påkrevde parametere

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

Løsning: Ta med alle påkrevde parametere i forespørselens body. Se endepunktdokumentasjonen for hele listen.

Ugyldig e-postadresse

{ "error": "invalid email" }

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

Ugyldig URL

{ "error": "invalid URL" }

Løsning: Oppgi en fullstendig URL med protokoll, 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.

Utstederen er 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 Verify Issuer.

Kvoten for legitimasjon er nådd (400)

{ "error": "Your Free plan reached its credential limit (1200/1200) — your allowance renews on your plan anniversary, or upgrade to Starter" }

Løsning: Du har brukt hele den årlige legitimasjonspuljen din (Free: 1 200/år, Starter: 12 000/år, Pro: 120 000/år). Puljen nullstilles på årsdagen for kontoregistreringen din — ikke ved månedsskifte. Oppgrader planen din for en høyere kvote. Se Planer og fakturering.

Plangrensen er nådd (400)

{ "error": "Your Free plan reached its issuer limit (2/2) — delete an issuer or upgrade to Starter" }

Grensen for merker har samme form:

{ "error": "badge limit reached (5/5 on the starter plan) — delete a badge or upgrade your plan" }

Løsning: Du har nådd planens grense for utstedere eller merker. Slett en ubrukt ressurs eller oppgrader planen din.

Ressursen har avhengigheter (400)

{ "error": "issuer has 3 badge(s) linked — delete the badges first" }

Løsning: Slett alle merker som er knyttet til utstederen før du sletter utstederen. Slett tilsvarende all legitimasjon under et merke før du sletter merket.

Ikke autorisert (400)

{ "error": "not authorized" }

Autorisasjonsfeil er valideringsfeil, så de returnerer 400 (ikke 401 eller 403).

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: Delingsteksten må være ren tekst. Fjern eventuelle HTML-tagger fra tekstparameteren.