Kode error SMS
Kode validasi sebelum penerimaan SMS (100xxx) dan hasil pengiriman setelah penerimaan (101xxx), kode bersama terkait, serta catatan kode lama.
Halaman ini merangkum kode error platform yang digunakan oleh API SMS. Semua kode bisnis berupa string enam digit; 000000 berarti operasi API berhasil. Untuk pengiriman SMS, berhasil berarti permintaan diterima, bukan pesan sudah terkirim. Baca hasil pengiriman akhir dari API kueri atau data callback.
Halaman ini mengikuti bagian SMS pada spesifikasi review: 100xxx untuk validasi pengajuan dan 101xxx untuk hasil pengiriman. Selalu cocokkan kode enam digit lengkap; prefiks hanya menunjukkan area katalog dan tidak menentukan perilaku percobaan ulang atau status penerimaan.
Rentang kode
| Rentang | Area | Arti |
|---|---|---|
010xxx | Permintaan dan resource | Parameter, format, status resource, dan konflik idempotensi. |
020xxx | Identitas dan akses | API Key, izin, aturan IP, akun, dan autentikasi. |
030xxx | Penagihan dan kuota | Saldo, kredit, kuota periodik, dan konfigurasi harga. |
040xxx | Laju dan konkurensi | Laju permintaan, laju pengajuan, dan batas konkurensi. |
050xxx | Layanan platform | Kegagalan internal dan hasil permintaan yang tidak diketahui. |
100xxx | Validasi pengajuan SMS | Ditolak sebelum diterima; perbaiki permintaan atau konfigurasi akun. |
101xxx | Hasil pengiriman SMS | Hasil per pesan setelah diterima; baca dari hasil kueri atau data callback. |
06xxx–09xxx | Cadangan umum | Dialokasikan secara terpusat setelah persetujuan. |
90xxx–99xxx | Tidak dialokasikan | Dicadangkan untuk perluasan di masa mendatang. |
Error umum
API SMS juga dapat mengembalikan kode dari rentang umum. Lihat halaman rentang untuk daftar lengkap dan panduan penanganan:
010xxx— Permintaan dan resource020xxx— Identitas dan akses030xxx— Penagihan dan kuota040xxx— Laju dan konkurensi050xxx— Layanan platform
Untuk 429 atau 503 sementara, tunggu Retry-After jika tersedia; jika tidak, gunakan backoff eksponensial berbatas. Jangan membuat permintaan SMS baru sebelum hasil permintaan asli diketahui.
Validasi pengajuan SMS (100xxx)
Hasil 100xxx berarti permintaan tidak diterima. Perbaiki penyebabnya, lalu kirim permintaan baru.
| Kode | Nama | Tindakan pelanggan | Coba ulang |
|---|---|---|---|
100001 | Pengirim belum terdaftar | Selesaikan pendaftaran pengirim. | Perbaiki lalu kirim ulang |
100002 | Template tidak dapat digunakan | Gunakan template yang disetujui dan aktif. | Perbaiki lalu kirim ulang |
100003 | Metode pengiriman tidak didukung | Gunakan pengirim atau metode yang didukung. | Perbaiki lalu kirim ulang |
100004 | Konten tidak diizinkan | Perbaiki konten sesuai aturan yang dipublikasikan. | Perbaiki lalu kirim ulang |
100005 | Pengirim tidak diotorisasi | Gunakan pengirim yang diotorisasi. | Perbaiki lalu kirim ulang |
100006 | Tujuan belum diaktifkan | Periksa cakupan tujuan atau minta akses. | Perbaiki lalu kirim ulang |
100007 | Konten tidak cocok dengan template | Buat konten dari template yang disetujui. | Perbaiki lalu kirim ulang |
100008 | Segmen SMS melebihi batas | Perpendek konten atau sesuaikan karakter. | Perbaiki lalu kirim ulang |
100009 | Penerima telah berhenti berlangganan | Hentikan pengiriman dan ikuti proses persetujuan. | Jangan kirim ulang otomatis |
100010 | Di luar jendela pengiriman | Tunggu jendela yang diizinkan dan periksa masa berlaku pesan. | Tunggu lalu coba ulang |
100011 | Tidak ada rute SMS | Coba lagi nanti; hubungi dukungan jika berlanjut. | Tunggu lalu coba ulang |
Kesalahan format nomor atau pengirim menggunakan 010003. Pengirim yang formatnya valid tetapi belum terdaftar menggunakan 100001. Jangan menyimpulkan pelanggaran konten jika respons tidak menyebutkannya.
Hasil pengiriman SMS (101xxx)
Kode 101xxx menjelaskan hasil pesan yang sudah diterima. Kode ini muncul di hasil kueri atau data callback, bukan sebagai error HTTP pada permintaan pengiriman.
| Kode | Nama | Tindakan pelanggan | Coba ulang |
|---|---|---|---|
101001 | Nomor penerima tidak valid | Periksa dan perbarui nomor. | Jangan kirim ulang otomatis |
101002 | Penerima sementara tidak dapat dijangkau | Putuskan apakah akan mengirim lagi dalam masa berlaku bisnis. | Jangan kirim ulang otomatis |
101003 | Operator menolak | Tinjau persyaratan tujuan dan hubungi dukungan jika perlu. | Jangan kirim ulang otomatis |
101004 | Tidak terkonfirmasi terkirim dalam masa berlaku | Tandai hasil tidak diketahui; jangan anggap pesan tidak diterima. | Jangan kirim ulang otomatis |
101005 | Konten diblokir hilir | Tinjau konten dan persyaratan tujuan. | Jangan kirim ulang otomatis |
101006 | Pengirim ditolak hilir | Periksa pendaftaran dan cakupan yang diizinkan. | Jangan kirim ulang otomatis |
101007 | Batas kapasitas hilir | Sesuaikan laju pengiriman berikutnya dan evaluasi pesan baru. | Jangan kirim ulang otomatis |
101008 | Kegagalan jaringan hilir | Pantau pemulihan dan putuskan apakah akan mengirim lagi. | Jangan kirim ulang otomatis |
101009 | Penerima menolak | Hentikan pengiriman dan catat penolakan. | Jangan kirim ulang otomatis |
101010 | Kedaluwarsa sebelum dikirim | Periksa masa berlaku, antrean, dan volume pengiriman. | Jangan kirim ulang otomatis |
101011 | Eksekusi platform gagal | Simpan message ID dan traceId lalu hubungi dukungan. | Jangan kirim ulang otomatis |
101012 | Pengiriman gagal, alasan tidak diketahui | Simpan message ID dan hubungi dukungan. | Jangan kirim ulang otomatis |
101004 berarti hasil pengiriman tidak diketahui; 101012 berarti pengiriman jelas gagal tetapi alasannya tidak diketahui. Pengiriman baru adalah operasi bisnis baru dan dapat menimbulkan biaya tambahan.
Aturan penanganan
000000berarti operasi API berhasil. Untuk pengiriman, ini hanya berarti permintaan diterima.- Kueri yang berhasil tetap dapat memuat pesan yang gagal. Dalam hal ini
codeterluar tetap000000dan kegagalan berada didata.errorCode. - Untuk
100xxx, perbaiki permintaan atau konfigurasi akun sebelum mengirim ulang. - Untuk
101xxx, jangan kirim ulang otomatis. Putuskan berdasarkan masa berlaku bisnis dan hasil pengiriman. - Untuk kode yang tidak terdokumentasi, catat
code,message, dantraceId, hentikan percobaan otomatis, lalu hubungi dukungan.
Terkait
Terakhir diperbarui pada