Fel

När en API-begäran misslyckas returnerar badges.ninja ett JSON-felsvar med en lämplig HTTP-statuskod.

Felformat

Alla fel följer denna struktur:

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

Statuskoder

Kod	Betydelse	När det händer
400	Bad Request	Saknade eller ogiltiga parametrar
402	Payment Required	Månatlig utmärkelsekvot uppnådd eller funktion kräver en högre plan
403	Forbidden	Plangräns uppnådd (t.ex. utfärdar- eller märkestak)
404	Not Found	Den begärda resursen existerar inte
429	Too Many Requests	Hastighetsgränsen överskriden
500	Internal Server Error	Ett oväntat fel inträffade på servern

Vanliga fel och lösningar

Saknade obligatoriska parametrar

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

Lösning: Inkludera alla obligatoriska parametrar i din begärans body. Kontrollera ändpunktsdokumentationen för den fullständiga listan.

Ogiltig e-post

{ "error": "invalid email" }

Lösning: Ange en giltig e-postadress i formatet user@domain.com.

Ogiltig URL

{ "error": "invalid URL" }

Lösning: Ange en fullständig URL inklusive protokollet, t.ex. https://example.com.

Namnet är för kort

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

Lösning: Använd ett längre namn. Utfärdarnamn kräver minst 3 tecken. Mottagarnamn kräver minst 5 tecken.

Utfärdaren inte verifierad

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

Lösning: Verifiera utfärdaren först. Kontrollera utfärdarens e-post för verifieringslänken, eller använd ändpunkten Verifiera utfärdare.

Månatlig utmärkelsekvot uppnådd

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

Lösning: Du har använt alla utmärkelser som ingår i din plan för denna faktureringsperiod (Free: 100/mån, Starter: 1 000/mån, Pro: 10 000/mån). Vänta på nästa återställning eller uppgradera din plan. Se Planer & Fakturering.

Plangräns uppnådd

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

Lösning: Du har nått din plans tak för utfärdare, märken eller API-nycklar. Ta bort en oanvänd resurs eller uppgradera din plan.

Blockchain kräver Pro

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

Lösning: Parametern blockchain är endast tillgänglig i Pro-planen. Uppgradera för att aktivera on-chain-verifiering.

Blockchain stöds inte

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

Lösning: För närvarande stöds endast matchain som blockchain-parameter.

Resurs har beroenden

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

Lösning: Ta bort alla märken under utfärdaren innan du tar bort utfärdaren. På samma sätt, ta bort alla utmärkelser under ett märke innan du tar bort märket.

Inte behörig

{ "error": "not authorized" }

Lösning: Du kan endast ändra resurser som du äger. Kontrollera att du använder rätt API-nyckel.

HTML i delningstext

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

Lösning: Delningstext måste vara klartext. Ta bort eventuella HTML-taggar från textparametern.