Kode error RCS
Error penerimaan pengiriman pesan RCS, kode khusus RCS 150xxx, status HTTP, dan panduan retry.
Halaman ini merangkum kode error penerimaan API pengiriman pesan RCS . Panggilan berhasil hanya jika HTTP 200 dan code=000000 terpenuhi; hasil penerimaan dinilai per item di data.messages[]. Pada keberhasilan parsial, code terluar tetap 000000, dan item yang gagal membawa kode enam digit terkait di status.
Kode error umum
Saat gagal, tentukan penyebab dari status HTTP dan code enam digit, dan simpan traceId untuk investigasi. Jangan membuat percabangan berdasarkan teks message; data=null saat seluruh permintaan gagal.
| HTTP | code | Arti dan penanganan |
|---|---|---|
| 400 | 010001 | Body permintaan bukan JSON valid atau tidak sesuai Content-Type yang dinyatakan. |
| 400 | 010002 | Field wajib tidak ada: productKey, sender (untuk pesan non-TEMPLATE/MMS), destinations, message.type, destinations[].to, sub-field smsFailover, dll.; lengkapi sesuai petunjuk message. |
| 400 | 010003 | Validasi tipe, format, enum, panjang, atau rentang field gagal (format nomor telepon, tipe pesan, validasi suggestion, productKey tidak valid, dll.); perbaiki sesuai petunjuk message. |
| 404 | 010005 | templateId tidak ada atau tidak dapat diakses akun ini; periksa ID template dan akunnya. |
| 400 | 010012 | Jumlah entri destinations melebihi batas satu permintaan; pecah permintaan. |
| 401 | 020001 | Authorization maupun AppID tidak disediakan. |
| 401 | 020002 | API KEY tidak ada, dinonaktifkan, atau kedaluwarsa. |
| 403 | 020005 | IP keluar tidak ada dalam allowlist; mode API Key mewajibkan allowlist, mode CheckSum hanya memeriksanya jika dikonfigurasi. |
| 401 | 020008 | Verifikasi CheckSum gagal, atau Nonce/CurTime/CheckSum hilang atau tidak valid; periksa API SECRET, algoritma, dan masukan tanda tangan asli. |
| 401 | 020009 | CurTime menyimpang lebih dari ±5 menit dari waktu server; sinkronkan jam dan buat autentikasi ulang. |
| 429 | 040001 | Batas laju permintaan terlampaui; kurangi laju dan patuhi header Retry-After. |
| 500 | 050001 | Kesalahan internal platform; penerimaan tidak dapat dipastikan. Simpan traceId dan hubungi dukungan — jangan kirim ulang sembarangan. |
Kode error khusus RCS (150xxx)
150xxx adalah rentang validasi pra-penerimaan khusus RCS/MMS: jika terjadi, item terkait tidak diterima. Lihat 150xxx — RCS / MMS untuk detail; 151xxx dicadangkan untuk hasil pengiriman dan tidak digunakan pada rilis ini.
| HTTP | code | Arti dan penanganan |
|---|---|---|
| 422 | 150001 | Tujuan mewajibkan pengiriman template: nomor Indonesia dikirim tanpa tipe TEMPLATE; kirim ulang sebagai pesan template. |
| 422 | 150002 | Variabel template kurang: lengkapi semua parameters yang dibutuhkan template, lalu kirim ulang. |
| 503 | 150003 | Tidak ada kanal yang cocok untuk template pemasok: coba lagi nanti; hubungi dukungan jika terus terjadi. |
| 422 | 150004 | Tidak ada sender valid yang tertaut: konfigurasikan sender untuk app key di konsol. |
| 503 | 150005 | Tidak ada kanal yang cocok untuk MMS: coba lagi nanti; hubungi dukungan jika terus terjadi. |
| 422 | 150006 | Konten duplikat diblokir: konten pemasaran mengenai aturan kemiripan duplikat; sesuaikan konten dan kirim ulang. |
| 422 | 150007 | Frekuensi pengiriman diblokir: konten pemasaran mengenai aturan frekuensi per-sender; turunkan frekuensi lalu coba lagi. |
| 422 | 150008 | Template belum disetujui: status tinjauan template bukan "disetujui"; gunakan template yang sudah disetujui. |
| 422 | 150009 | Penerima di blocklist: hentikan pengiriman ke nomor ini dan ikuti proses kepatuhan; jangan kirim ulang otomatis. |
Untuk kontrak API RCS lihat Kirim pesan RCS; untuk struktur kode umum dan rentang produk lain lihat ringkasan kode error.
Terakhir diperbarui pada