Fejl

Når en API-forespørgsel fejler, returnerer badges.ninja et JSON-fejlsvar med en passende HTTP-statuskode.

Fejlformat

Alle fejl følger denne struktur:

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

Statuskoder

Kode	Betydning	Hvornår det sker
400	Bad Request	Manglende eller ugyldige parametre, plangrænse eller kvote nået, funktionen kræver en højere plan, eller manglende autorisation — alle valideringsfejl returnerer 400
402	Payment Required	Reserveret til opbrugte credits. Badges-API'et trækker i øjeblikket ikke credits, så denne kode returneres aldrig i praksis
404	Not Found	Den ønskede ressource findes ikke
500	Internal Server Error	Der opstod en uventet fejl på serveren

Der findes hverken 403 eller 429: autorisationsfejl returnerer 400 („not authorized“), og der er ingen rate limiting på applikationslaget.

Almindelige fejl og løsninger

Manglende påkrævede parametre

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

Løsning: Medtag alle påkrævede parametre i din forespørgselskrop. Se endpointets dokumentation for den fulde liste.

Ugyldig e-mail

{ "error": "invalid email" }

Løsning: Angiv en gyldig e-mailadresse i formatet user@domain.com.

Ugyldig URL

{ "error": "invalid URL" }

Løsning: Angiv en fuld URL inklusive protokollen, f.eks. https://example.com.

Navn for kort

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

Løsning: Brug et længere navn. Udsteder-navne kræver mindst 3 tegn. Modtager-navne kræver mindst 5 tegn.

Udsteder ikke verificeret

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

Løsning: Verificér først udstederen. Find verificeringslinket i udstederens e-mail, eller brug endpointet Verificér udsteder.

Bevis-kvote nået (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 brugt hele din årlige bevis-pulje (Free: 1.200/år, Starter: 12.000/år, Pro: 120.000/år). Puljen nulstilles på årsdagen for din kontos registrering — ikke ved kalendermånedsskift. Opgradér din plan for at få en højere kvote. Se Planer og fakturering.

Plangrænse nået (400)

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

Grænsen for badges 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ået din plans grænse for udstedere eller badges. Slet en ubrugt ressource, eller opgradér din plan.

Ressourcen har afhængigheder (400)

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

Løsning: Slet alle badges, der er knyttet til udstederen, før du sletter udstederen. På samme måde skal du slette alle beviser under et badge, før du sletter badget.

Ikke autoriseret (400)

{ "error": "not authorized" }

Autorisationsfejl er valideringsfejl, så de returnerer 400 (ikke 401 eller 403).

Løsning: Du kan kun ændre ressourcer, du ejer. Sørg for, at du bruger den rigtige API-nøgle.

HTML i delingstekst

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

Løsning: Delingsteksten skal være ren tekst. Fjern alle HTML-tags fra tekstparameteren.