Katalog Kode Error & Penanganannya
Saat berinteraksi dengan API DagangBot dalam pengembangan integrasi maupun operasional harian, Anda dapat menemui kode balasan error apabila terjadi kegagalan validasi masukan, limitasi kuota paket bisnis, pembatasan rate limiting, atau interupsi teknis pada sisi server (backend). Halaman ini memuat referensi spesifik dari berbagai konstanta kode error (Error Code) internal yang dihasilkan oleh komponen inti sistem kami.
Memahami tipe dan anatomi respons error memungkinkan administrator dan pengembang sistem Anda mengonfigurasi mekanisme coba ulang otomatis (retry logic) yang tangguh, serta memastikan resolusi kendala (troubleshooting) berjalan cepat tanpa kerancuan informasi.
1. Anatomi & Format Respons Error
Seluruh respons kegagalan API platform akan selalu dikonversi menjadi format standar JSON. Objek tingkat tinggi (top-level) error bertugas menyimpan serangkaian properti yang menguraikan konteks kegagalan tersebut:
{
"error": {
"code": "STRING",
"message": "STRING",
"details": "ANY"
}
}Rincian struktural masing-masing atribut:
code: Merupakan string huruf kapital bernilai konstan secara programatis (contoh:UNAUTHORIZED,QUOTA_EXCEEDED,INVALID_BODY). Tim teknis Anda wajib merujuk pada parameter ini untuk membangun kondisi logika evaluasi (if-else/switch) aplikasi penarik (client application).message: Berisi deskripsi deskriptif tingkat lanjut namun aman untuk ditampilkan kepada pengguna akhir (end-user). Pesan ini telah dirancang untuk menghindari bocornya jejak tumpukan kode (stack trace) yang mengekspos lapisan keamanan.details: Informasi ekstra yang sangat bergantung pada konteks endpoint. Saat Anda berhadapan dengan error bertipeVALIDATION_FAILED, elemendetailsakan diisi oleh koleksi array yang menyebut spesifikasi field mana yang salah format, nilai yang terlalu panjang, atau properti wajib yang diabaikan.
2. Autentikasi, Identitas & Sesi Kredensial
Segmen ini menaungi kelompok penolakan koneksi akibat izin token tidak valid, permasalahan sesi aplikasi, perlindungan antar-cabang, atau kegagalan proteksi CSRF di ranah portal pengguna.
3. Akun Tenant, Restriksi & Penguasaan Kuota
Kode eksepsi yang dikembalikan kala interaksi menabrak perbatasan pembatasan fitur (Plan Gating), hambatan saldo koin, kecepatan trafik ekstrem, atau tumpang tindih pendaftaran aset alamat surel.
4. Perangkat WhatsApp & Infrastruktur Gateway
Integrasi fungsional komunikasi berbalas otomatis bertumpu pada arsitektur node Omnichannel WA. Kesalahan di area ini mencakup limitasi instansiasi alat dan penolakan jembatan transmisi pesan masuk maupun keluar.
5. Mesin Sinkronisasi Konektor Bisnis
Terkait upaya sistem DagangBot bertukar tumpukan informasi secara simultan bersama platform third-party (contoh: platform e-commerce) atau pembacaan instrumen data massal CSV internal.
6. Dinamika Keuangan, Transaksi Pembayaran & Tagihan Koin
Resistensi yang diakibatkan penolakan otorisasi Payment Gateway Xendit/Midtrans, degradasi sirkulasi penagihan faktur, atau defisit amunisi modal transaksi wallet koin pada All-in-One API.
7. Trasmisi Relai Webhook (Event Notification)
Ketepatan penyaluran sinyal notifikasi eksternal pada infrastruktur milik pelaksana luar sangat berpengaruh pada munculnya rentetan error logikal.
8. Modul RAG Vector & Layanan Engine AI
Error khusus yang mewakili perilaku deterministik mesin model bahasa (Large Language Models), distorsi data sumber dokumen vektor Knowledge Base, atau putusnya rel layanan asisten pintar (ASPRI AI).
9. Kegagalan Fondasi Validasi Standar & Cacat Skema
Masalah lapisan teknis paling bawah, memengaruhi struktur kerangka badan permintaan HTTP (HTTP Request Body) hingga hilangnya data dari referensi database.
Apabila serangkaian observasi respons ini masih memicu kebuntuan analitik, Anda mutlak disarankan menyelidiki simptom penyerta lainnya melewati artikel dedikasi Pemecahan Masalah Lintas Modul.
10. Batasan Cakupan Galat yang Terdokumentasi
Spesifikasi antarmuka API publik memastikan bentuk respons standar untuk status sukses dan penanganan galat. Daftar kode galat pada halaman ini mencakup seluruh kode penanganan galat resmi yang aktif digunakan di peladen untuk memudahkan penanganan galat (error handling) terprediksi.
