Mga Error

Kapag nabigo ang isang API request, nagbabalik ang badges.ninja ng JSON error response na may angkop na HTTP status code.

Format ng Error

Lahat ng error ay may ganitong istruktura:

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

Mga Status Code

Code	Kahulugan	Kailan Ito Nangyayari
400	Bad Request	Kulang o di-wastong mga parameter, naabot ang plan limit o quota, kailangan ng mas mataas na plan ang feature, o hindi awtorisado — lahat ng validation failure ay nagbabalik ng 400
402	Payment Required	Nakalaan para sa pagkaubos ng credit. Kasalukuyang hindi nagbabawas ng credit ang badges API, kaya hindi kailanman ibinabalik ang code na ito sa praktika
404	Not Found	Walang umiiral na hinihinging resource
500	Internal Server Error	May hindi inaasahang error sa server

Walang 403 o 429: ang mga authorization failure ay nagbabalik ng 400 ("not authorized") at walang application-layer rate limiting.

Mga Karaniwang Error at Solusyon

Kulang na kinakailangang mga parameter

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

Solusyon: Isama ang lahat ng kinakailangang parameter sa request body mo. Tingnan ang dokumentasyon ng endpoint para sa buong listahan.

Di-wastong email

{ "error": "invalid email" }

Solusyon: Magbigay ng wastong email address sa format na user@domain.com.

Di-wastong URL

{ "error": "invalid URL" }

Solusyon: Magbigay ng buong URL kasama ang protocol, hal. https://example.com.

Masyadong maikli ang pangalan

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

Solusyon: Gumamit ng mas mahabang pangalan. Kailangan ng hindi bababa sa 3 character ang pangalan ng issuer. Kailangan ng hindi bababa sa 5 character ang pangalan ng recipient.

Hindi pa na-verify ang issuer

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

Solusyon: I-verify muna ang issuer. Tingnan ang email ng issuer para sa verification link, o gamitin ang I-verify ang Issuer na endpoint.

Naabot na ang credential quota (400)

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

Solusyon: Nagamit mo na ang buong taunang credential pool mo (Free: 1,200/taon, Starter: 12,000/taon, Pro: 120,000/taon). Nagre-reset ang pool sa anibersaryo ng pagpaparehistro ng account mo — hindi sa hangganan ng kalendaryong buwan. I-upgrade ang plan mo para sa mas mataas na allowance. Tingnan ang Mga Plan at Billing.

Naabot na ang plan limit (400)

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

Ganito rin ang hugis ng limit sa badge:

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

Solusyon: Naabot mo na ang limitasyon ng plan mo sa mga issuer o badge. Magtanggal ng hindi ginagamit na resource o i-upgrade ang plan mo.

May mga dependency ang resource (400)

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

Solusyon: Tanggalin muna ang lahat ng badge na naka-link sa issuer bago tanggalin ang issuer. Gayundin, tanggalin ang lahat ng credential sa ilalim ng isang badge bago tanggalin ang badge.

Hindi awtorisado (400)

{ "error": "not authorized" }

Mga validation error ang authorization failure, kaya nagbabalik ang mga ito ng 400 (hindi 401 o 403).

Solusyon: Maaari mo lang baguhin ang mga resource na pagmamay-ari mo. Tiyaking tama ang API key na ginagamit mo.

May HTML sa share text

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

Solusyon: Dapat plain text ang share text. Alisin ang anumang HTML tag sa text parameter.