Hibák

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

Hibaformátum

Minden hiba az alábbi 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
402	Payment Required	Havi kiadási keret elérve, vagy a funkció magasabb csomagot kíván
403	Forbidden	Csomagkorlát elérve (pl. kibocsátó- vagy jelvénylimit)
404	Not Found	A kért erőforrás nem létezik
429	Too Many Requests	A sebességhatár túllépve
500	Internal Server Error	Váratlan hiba a kiszolgálón

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: Add meg a 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: Hosszabb nevet válassz. A kibocsátónevek legalább 3 karakteresek. A címzettnevek legalább 5 karakteresek.

Nem ellenőrzött kibocsátó

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

Megoldás: Előbb ellenőrizd a kibocsátót. Nézd meg a kibocsátó e-mail-fiókját az ellenőrző hivatkozás miatt, vagy használd a Kibocsátó ellenőrzése végpontot.

Havi kiadási keret elérve

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

Megoldás: Felhasználtad az ebben a számlázási időszakban a csomagodhoz tartozó összes kiadást (Free: 100/hó, Starter: 1000/hó, Pro: 10 000/hó). Várd ki a következő visszaállítást, vagy bővítsd a csomagot. Lásd: Csomagok és számlázás.

Csomaghatár elérve

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

Megoldás: Elérted a csomag felső határát kibocsátók, jelvények vagy API-kulcsok terén. Törölj egy fel nem használt erőforrást, vagy bővítsd a csomagot.

A blockchainhez Pro szükséges

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

Megoldás: A blockchain paraméter csak Pro csomagban érhető el. A láncon történő ellenőrzéshez bővítsd a csomagot.

Nem támogatott blockchain

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

Megoldás: Jelenleg csak a matchain támogatott blockchain-paraméterként.

Az erőforrásnak függősége van

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

Megoldás: Töröld a kibocsátó összes jelvényét, mielőtt törölnéd a kibocsátót. Ugyanígy töröld a jelvény összes kiadását a jelvény törlése előtt.

Nincs jogosultság

{ "error": "not authorized" }

Megoldás: Csak azokat az erőforrásokat tudod módosítani, amelyek a tiéid. 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öveg csak egyszerű szöveg lehet. Távolíts el minden HTML-címkét a szövegparaméterből.