Hibák

Ha egy API-kérés sikertelen, a badges.ninja JSON hibaválaszt ad vissza a megfelelő HTTP-állapotkóddal.

Hibaformátum

Minden hiba ezt a szerkezetet követi:

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

Állapotkódok

Kód	Jelentés	Mikor fordul elő
400	Bad Request	Hiányzó vagy érvénytelen paraméterek, elérted a csomaglimitet vagy a kvótát, a funkcióhoz magasabb csomag kell, vagy nincs jogosultságod — minden validációs hiba 400-at ad vissza
402	Payment Required	A kreditek kimerülésére fenntartva. A badges API jelenleg nem von le krediteket, ezért ezt a kódot a gyakorlatban soha nem adja vissza
404	Not Found	A kért erőforrás nem létezik
500	Internal Server Error	Váratlan hiba történt a szerveren

Nincs 403 és 429: a jogosultsági hibák 400-at ("not authorized") adnak vissza, és alkalmazásszintű sebességkorlátozás sincs.

Gyakori hibák és megoldások

Hiányzó kötelező paraméterek

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

Megoldás: Add meg az összes kötelező paramétert a kérés törzsében. A teljes listát a végpont dokumentációjában találod.

Érvénytelen e-mail-cím

{ "error": "invalid email" }

Megoldás: Adj meg érvényes e-mail-címet user@domain.com formátumban.

Érvénytelen URL

{ "error": "invalid URL" }

Megoldás: Adj meg teljes URL-t a protokollal együtt, pl. https://example.com.

Túl rövid név

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

Megoldás: Használj hosszabb nevet. A kibocsátók nevének legalább 3 karakteresnek kell lennie. A címzettek nevének legalább 5 karakteresnek kell lennie.

A kibocsátó nincs ellenőrizve

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

Megoldás: Előbb ellenőrizd a kibocsátót. Keresd az ellenőrző hivatkozást a kibocsátó e-mail-címére küldött levélben, vagy használd a Kibocsátó ellenőrzése végpontot.

Elérted a hitelesítőadat-kvótát (400)

{ "error": "Your Free plan reached its credential limit (1200/1200) — your allowance renews on your plan anniversary, or upgrade to Starter" }

Megoldás: Felhasználtad a teljes éves hitelesítőadat-keretedet (Free: 1200/év, Starter: 12 000/év, Pro: 120 000/év). A keret a fiókod regisztrációs évfordulóján nullázódik — nem naptári hónaphatáron. Magasabb keretért válts magasabb csomagra. Lásd: Csomagok és számlázás.

Elérted a csomaglimitet (400)

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

A jelvények felső korlátja ugyanilyen alakú:

{ "error": "badge limit reached (5/5 on the starter plan) — delete a badge or upgrade your plan" }

Megoldás: Elérted a csomagod felső korlátját a kibocsátókra vagy a jelvényekre vonatkozóan. Törölj egy nem használt erőforrást, vagy válts magasabb csomagra.

Az erőforrásnak függőségei vannak (400)

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

Megoldás: A kibocsátó törlése előtt töröld az összes hozzá kapcsolt jelvényt. Hasonlóképpen, a jelvény törlése előtt töröld a jelvényhez tartozó összes hitelesítő adatot.

Nincs jogosultság (400)

{ "error": "not authorized" }

A jogosultsági hibák validációs hibák, ezért 400-at adnak vissza (nem 401-et vagy 403-at).

Megoldás: Csak a saját tulajdonú erőforrásaidat módosíthatod. Győződj meg róla, hogy a megfelelő API-kulcsot használod.

HTML a megosztási szövegben

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

Megoldás: A megosztási szövegnek egyszerű szövegnek kell lennie. Távolíts el minden HTML-címkét a text paraméterből.