Fouten

Wanneer een API-verzoek mislukt, retourneert badges.ninja een JSON-foutrespons met de bijbehorende HTTP-statuscode.

Foutformaat

Alle fouten volgen deze structuur:

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

Statuscodes

Code	Betekenis	Wanneer gebeurt het
400	Bad Request	Ontbrekende of ongeldige parameters
402	Payment Required	Maandelijks uitreikingsquotum bereikt of functie vereist een hoger abonnement
403	Forbidden	Limiet van het abonnement bereikt (bijvoorbeeld limiet voor uitgevers of badges)
404	Not Found	De gevraagde resource bestaat niet
429	Too Many Requests	Snelheidslimiet overschreden
500	Internal Server Error	Er is een onverwachte fout op de server opgetreden

Veelvoorkomende fouten en oplossingen

Verplichte parameters ontbreken

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

Oplossing: Voeg alle verplichte parameters toe aan de body van je verzoek. Raadpleeg de endpoint-documentatie voor de volledige lijst.

Ongeldig e-mailadres

{ "error": "invalid email" }

Oplossing: Geef een geldig e-mailadres op in de vorm user@domain.com.

Ongeldige URL

{ "error": "invalid URL" }

Oplossing: Geef een volledige URL inclusief het protocol op, bijvoorbeeld https://example.com.

Naam te kort

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

Oplossing: Gebruik een langere naam. Namen van uitgevers vereisen minstens 3 tekens. Namen van ontvangers vereisen minstens 5 tekens.

Uitgever niet geverifieerd

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

Oplossing: Verifieer de uitgever eerst. Controleer het e-mailadres van de uitgever voor de verificatielink, of gebruik het endpoint Uitgever verifiëren.

Maandelijks uitreikingsquotum bereikt

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

Oplossing: Je hebt alle in je abonnement opgenomen uitreikingen voor deze factuurperiode gebruikt (Free: 100/maand, Starter: 1.000/maand, Pro: 10.000/maand). Wacht op de volgende reset of upgrade je abonnement. Zie Abonnementen en facturatie.

Limiet van abonnement bereikt

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

Oplossing: Je hebt de limiet van je abonnement voor uitgevers, badges of API-sleutels bereikt. Verwijder een ongebruikte resource of upgrade je abonnement.

Blockchain vereist Pro

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

Oplossing: De parameter blockchain is alleen beschikbaar in het Pro-abonnement. Upgrade om verificatie op de keten te activeren.

Niet-ondersteunde blockchain

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

Oplossing: Momenteel wordt alleen matchain ondersteund als blockchain-parameter.

Resource met afhankelijkheden

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

Oplossing: Verwijder alle badges onder de uitgever voordat je de uitgever verwijdert. Op dezelfde wijze verwijder je alle uitreikingen onder een badge voordat je de badge verwijdert.

Niet geautoriseerd

{ "error": "not authorized" }

Oplossing: Je kunt alleen resources aanpassen die van jou zijn. Zorg dat je de juiste API-sleutel gebruikt.

HTML in deeltekst

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

Oplossing: De deeltekst moet platte tekst zijn. Verwijder alle HTML-tags uit de tekstparameter.