Kesalahan

Saat permintaan API gagal, badges.ninja mengembalikan respons kesalahan JSON dengan kode status HTTP yang sesuai.

Format Kesalahan

Semua kesalahan mengikuti struktur ini:

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

Kode Status

Kode	Arti	Kapan Terjadi
400	Bad Request	Parameter yang hilang atau tidak valid
402	Payment Required	Kuota penghargaan bulanan tercapai atau fitur memerlukan paket lebih tinggi
403	Forbidden	Batas paket tercapai (mis. batas penerbit atau lencana)
404	Not Found	Sumber daya yang diminta tidak ada
429	Too Many Requests	Batas tarif terlampaui
500	Internal Server Error	Kesalahan tidak terduga terjadi di server

Kesalahan Umum dan Solusi

Parameter yang diperlukan hilang

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

Solusi: Sertakan semua parameter yang diperlukan dalam badan permintaan Anda. Periksa dokumentasi endpoint untuk daftar lengkap.

Surel tidak valid

{ "error": "invalid email" }

Solusi: Berikan alamat surel yang valid dalam format user@domain.com.

URL tidak valid

{ "error": "invalid URL" }

Solusi: Berikan URL lengkap termasuk protokol, mis. https://example.com.

Nama terlalu pendek

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

Solusi: Gunakan nama yang lebih panjang. Nama penerbit memerlukan minimum 3 karakter. Nama penerima memerlukan minimum 5 karakter.

Penerbit tidak diverifikasi

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

Solusi: Verifikasi penerbit dahulu. Periksa surel penerbit untuk tautan verifikasi, atau gunakan endpoint Verifikasi Penerbit.

Kuota penghargaan bulanan tercapai

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

Solusi: Anda telah menggunakan semua penghargaan yang termasuk dalam paket Anda untuk periode penagihan ini (Free: 100/mo, Starter: 1,000/mo, Pro: 10,000/mo). Tunggu reset berikutnya atau tingkatkan paket Anda. Lihat Paket & Penagihan.

Batas paket tercapai

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

Solusi: Anda telah mencapai batas paket Anda pada penerbit, lencana, atau kunci API. Hapus sumber daya yang tidak digunakan atau tingkatkan paket Anda.

Blockchain memerlukan Pro

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

Solusi: Parameter blockchain hanya tersedia pada paket Pro. Tingkatkan untuk mengaktifkan verifikasi on-chain.

Blockchain tidak didukung

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

Solusi: Saat ini hanya matchain yang didukung sebagai parameter blockchain.

Sumber daya memiliki dependensi

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

Solusi: Hapus semua lencana di bawah penerbit sebelum menghapus penerbit. Demikian pula, hapus semua penghargaan di bawah lencana sebelum menghapus lencana.

Tidak diizinkan

{ "error": "not authorized" }

Solusi: Anda hanya dapat memodifikasi sumber daya yang Anda miliki. Pastikan Anda menggunakan kunci API yang benar.

HTML dalam teks berbagi

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

Solusi: Teks berbagi harus berupa teks biasa. Hapus tag HTML apa pun dari parameter teks.