Mga Error

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

Format ng Error

Lahat ng error ay sumusunod sa istrukturang ito:

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

Mga Status Code

Code	Kahulugan	Kailan Nangyayari
400	Bad Request	Nawawalang o invalid na parameter
402	Payment Required	Naabot ang buwanang quota ng award o ang feature ay nangangailangan ng mas mataas na plan
403	Forbidden	Naabot ang plan-limit (hal. issuer o badge cap)
404	Not Found	Hindi umiiral ang hiniling na resource
429	Too Many Requests	Nalampasan ang rate limit
500	Internal Server Error	May di-inaasahang error na nangyari sa server

Mga Karaniwang Error at Solusyon

Nawawalang kinakailangang parameter

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

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

Invalid na email

{ "error": "invalid email" }

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

Invalid na 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. Ang mga pangalan ng issuer ay nangangailangan ng minimum 3 character. Ang mga pangalan ng tatanggap ay nangangailangan ng minimum 5 character.

Hindi pa verified ang issuer

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

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

Naabot ang buwanang quota ng award

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

Solusyon: Nagamit na ninyo ang lahat ng award na kasama sa inyong plan para sa billing period na ito (Free: 100/mo, Starter: 1,000/mo, Pro: 10,000/mo). Maghintay para sa susunod na reset o i-upgrade ang inyong plan. Tingnan ang Plans & Billing.

Naabot ang plan limit

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

Solusyon: Naabot ninyo ang cap ng inyong plan sa issuer, badge, o API keys. Burahin ang isang hindi ginagamit na resource o i-upgrade ang inyong plan.

Kailangan ng Pro ang blockchain

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

Solusyon: Ang blockchain parameter ay available lang sa Pro plan. Mag-upgrade para paganahin ang on-chain verification.

Hindi suportadong blockchain

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

Solusyon: Sa kasalukuyan, matchain lang ang sinusuportahan bilang blockchain parameter.

May dependencies ang resource

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

Solusyon: Burahin lahat ng badge sa ilalim ng issuer bago burahin ang issuer. Gayundin, burahin lahat ng award sa ilalim ng badge bago burahin ang badge.

Hindi awtorisado

{ "error": "not authorized" }

Solusyon: Maaari lang ninyong baguhin ang mga resource na pag-aari ninyo. Siguraduhing gumagamit kayo ng tamang API key.

HTML sa share text

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

Solusyon: Ang share text ay dapat plain text. Alisin ang anumang HTML tag sa text parameter.