Ralat

Apabila permintaan API gagal, badges.ninja memulangkan respons ralat JSON dengan kod status HTTP yang sesuai.

Format Ralat

Semua ralat mengikut struktur ini:

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

Kod Status

Kod	Maksud	Bila Ia Berlaku
400	Bad Request	Parameter tiada atau tidak sah, had pelan atau kuota dicapai, ciri memerlukan pelan lebih tinggi, atau tidak dibenarkan — semua kegagalan pengesahan input memulangkan 400
402	Payment Required	Dikhaskan untuk kehabisan kredit. API badges pada masa ini tidak menolak kredit, jadi kod ini tidak pernah dipulangkan dalam praktik
404	Not Found	Sumber yang diminta tidak wujud
500	Internal Server Error	Ralat tidak dijangka berlaku pada pelayan

Tiada 403 atau 429: kegagalan kebenaran memulangkan 400 ("not authorized") dan tiada had kadar pada lapisan aplikasi.

Ralat Biasa dan Penyelesaian

Parameter wajib tiada

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

Penyelesaian: Sertakan semua parameter wajib dalam badan permintaan anda. Semak dokumentasi titik akhir untuk senarai lengkap.

E-mel tidak sah

{ "error": "invalid email" }

Penyelesaian: Berikan alamat e-mel yang sah dalam format user@domain.com.

URL tidak sah

{ "error": "invalid URL" }

Penyelesaian: Berikan URL penuh termasuk protokol, contohnya https://example.com.

Nama terlalu pendek

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

Penyelesaian: Gunakan nama yang lebih panjang. Nama pengeluar memerlukan sekurang-kurangnya 3 aksara. Nama penerima memerlukan sekurang-kurangnya 5 aksara.

Pengeluar belum disahkan

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

Penyelesaian: Sahkan pengeluar terlebih dahulu. Semak e-mel pengeluar untuk pautan pengesahan, atau gunakan titik akhir Verify Issuer.

Kuota kelayakan dicapai (400)

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

Penyelesaian: Anda telah menggunakan keseluruhan kumpulan kelayakan tahunan anda (Free: 1,200/tahun, Starter: 12,000/tahun, Pro: 120,000/tahun). Kumpulan ini ditetapkan semula pada ulang tahun pendaftaran akaun anda — bukan pada sempadan bulan kalendar. Naik taraf pelan anda untuk peruntukan yang lebih tinggi. Lihat Pelan & Pengebilan.

Had pelan dicapai (400)

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

Had lencana menggunakan bentuk yang sama:

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

Penyelesaian: Anda telah mencapai had pelan anda bagi pengeluar atau lencana. Padam sumber yang tidak digunakan atau naik taraf pelan anda.

Sumber mempunyai kebergantungan (400)

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

Penyelesaian: Padam semua lencana yang dipautkan kepada pengeluar sebelum memadam pengeluar. Begitu juga, padam semua kelayakan di bawah sesuatu lencana sebelum memadam lencana tersebut.

Tidak dibenarkan (400)

{ "error": "not authorized" }

Kegagalan kebenaran ialah ralat pengesahan input, jadi ia memulangkan 400 (bukan 401 atau 403).

Penyelesaian: Anda hanya boleh mengubah suai sumber yang anda miliki. Pastikan anda menggunakan kunci API yang betul.

HTML dalam teks perkongsian

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

Penyelesaian: Teks perkongsian mestilah teks biasa. Buang sebarang teg HTML daripada parameter teks.