Virheet

Kun API-pyyntö epäonnistuu, badges.ninja palauttaa JSON-virhevastauksen asianmukaisella HTTP-tilakoodilla.

Virheen muoto

Kaikki virheet noudattavat tätä rakennetta:

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

Tilakoodit

Koodi	Merkitys	Milloin se tapahtuu
400	Bad Request	Puuttuvat tai virheelliset parametrit
402	Payment Required	Kuukausittainen myöntökiintiö saavutettu tai ominaisuus vaatii korkeamman tilauksen
403	Forbidden	Tilausraja saavutettu (esim. myöntäjä- tai merkkikatto)
404	Not Found	Pyydettyä resurssia ei ole olemassa
429	Too Many Requests	Nopeusrajoitus ylittynyt
500	Internal Server Error	Palvelimella tapahtui odottamaton virhe

Yleiset virheet ja ratkaisut

Puuttuvat pakolliset parametrit

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

Ratkaisu: Sisällytä kaikki pakolliset parametrit pyyntösi runkoon. Tarkista päätepisteen dokumentaatio täydellisen luettelon saamiseksi.

Virheellinen sähköposti

{ "error": "invalid email" }

Ratkaisu: Anna kelvollinen sähköpostiosoite muodossa user@domain.com.

Virheellinen URL

{ "error": "invalid URL" }

Ratkaisu: Anna täysi URL mukaan lukien protokolla, esim. https://example.com.

Nimi liian lyhyt

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

Ratkaisu: Käytä pidempää nimeä. Myöntäjän nimet vaativat vähintään 3 merkkiä. Vastaanottajan nimet vaativat vähintään 5 merkkiä.

Myöntäjä ei ole varmennettu

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

Ratkaisu: Varmenna myöntäjä ensin. Tarkista myöntäjän sähköposti varmistuslinkkiä varten tai käytä päätepistettä Varmenna myöntäjä.

Kuukausittainen myöntökiintiö saavutettu

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

Ratkaisu: Olet käyttänyt kaikki tilauksessasi sisältyvät myönnöt tällä laskutuskaudella (Free: 100/kk, Starter: 1 000/kk, Pro: 10 000/kk). Odota seuraavaa nollausta tai päivitä tilauksesi. Katso Tilaukset & laskutus.

Tilausraja saavutettu

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

Ratkaisu: Olet saavuttanut tilauksesi katon myöntäjille, merkeille tai API-avaimille. Poista käyttämätön resurssi tai päivitä tilauksesi.

Blockchain vaatii Pron

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

Ratkaisu: Parametri blockchain on saatavilla vain Pro-tilauksessa. Päivitä aktivoidaksesi on-chain-varmistuksen.

Tukematon blockchain

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

Ratkaisu: Tällä hetkellä vain matchain on tuettu blockchain-parametrina.

Resurssilla on riippuvuuksia

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

Ratkaisu: Poista kaikki myöntäjän alla olevat merkit ennen myöntäjän poistamista. Samoin poista kaikki merkin alla olevat myönnöt ennen merkin poistamista.

Ei valtuutusta

{ "error": "not authorized" }

Ratkaisu: Voit muokata vain omistamiasi resursseja. Varmista, että käytät oikeaa API-avainta.

HTML jakamistekstissä

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

Ratkaisu: Jakamistekstin on oltava tavallista tekstiä. Poista kaikki HTML-tunnisteet tekstiparametrista.