Fejl

Når en API-forespørgsel mislykkes, 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
402	Payment Required	Månedlig udmærkelseskvote nået, eller funktion kræver en højere plan
403	Forbidden	Plan-grænse nået (f.eks. udsteder- eller mærkeloft)
404	Not Found	Den anmodede ressource findes ikke
429	Too Many Requests	Hastighedsgrænse overskredet
500	Internal Server Error	En uventet fejl opstod på serveren

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ørgsels body. Tjek endpoint-dokumentationen 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.

Navnet er for kort

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

Løsning: Brug et længere navn. Udstedernavne kræver mindst 3 tegn. Modtagernavne kræver mindst 5 tegn.

Udsteder ikke verificeret

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

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

Månedlig udmærkelseskvote nået

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

Løsning: Du har brugt alle udmærkelser inkluderet i din plan for denne faktureringsperiode (Free: 100/md, Starter: 1.000/md, Pro: 10.000/md). Vent på næste nulstilling, eller opgrader din plan. Se Planer & Fakturering.

Plan-grænse nået

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

Løsning: Du har nået din plans loft for udstedere, mærker eller API-nøgler. Slet en ubrugt ressource, eller opgrader din plan.

Blockchain kræver Pro

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

Løsning: Parameteren blockchain er kun tilgængelig i Pro-planen. Opgradér for at aktivere on-chain-verificering.

Ikke-understøttet blockchain

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

Løsning: I øjeblikket understøttes kun matchain som blockchain-parameter.

Ressource har afhængigheder

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

Løsning: Slet alle mærker under udstederen, før du sletter udstederen. Slet ligeledes alle udmærkelser under et mærke, før du sletter mærket.

Ikke autoriseret

{ "error": "not authorized" }

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

HTML i delingstekst

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

Løsning: Delingstekst skal være almindelig tekst. Fjern eventuelle HTML-tags fra tekst-parameteren.