Kode error email
Error penerimaan email, status HTTP, panduan percobaan ulang, dan alasan kegagalan setelah diterima.
Halaman ini merangkum error penerimaan email dan alasan kegagalan setelah diterima. Keberhasilan memerlukan HTTP 202 dan code=000000; diterima tidak berarti terkirim.
Error penerimaan
Gunakan status HTTP dan code enam digit untuk menentukan tindakan. Simpan traceId untuk dukungan; jangan mengambil keputusan berdasarkan teks message.
Saat gagal, data=null. message bersifat dinamis dan tidak boleh menjadi satu-satunya kriteria keputusan.
| HTTP | code | Arti dan tindakan |
|---|---|---|
| 400 | 010001 | JSON atau body permintaan tidak valid. |
| 400 | 010002 | Header wajib selain idempotensi tidak disertakan. |
| 400 | 010003 | Validasi field, parameter bisnis, atau X-Custom-TraceId gagal. |
| 400 | 010013 | Kunci idempotensi tidak disertakan atau tidak valid. |
| 405 | 010009 | Metode HTTP tidak didukung. |
| 415 | 010010 | Content-Type tidak didukung. |
| 401 | 020001 | AppID atau API Key tidak disertakan. |
| 401 | 020002 | API Key tidak valid, tidak dikenal, atau dinonaktifkan. |
| 401 | 020008 | Header tanda tangan tidak lengkap, tanda tangan salah, atau Nonce diputar ulang; buat ulang dan periksa kredensial. |
| 401 | 020009 | Format CurTime valid tetapi berada di luar jendela; sinkronkan jam dan tanda tangani ulang. |
| 403 | 020005 | IP egress tidak diizinkan atau konfigurasi allowlist tidak valid. |
| 409 | 010007 | Kunci idempotensi terkait konten berbeda; hentikan percobaan otomatis. |
| 409 | 010008 | Tugas asli masih diproses; gunakan backoff terbatas dengan kunci dan body asli. |
| 403 | 030003 | Kuota harian API Key tercapai. |
| 429 | 040001 | Laju jangka pendek terlampaui; ikuti Retry-After. |
| 500 | 050001 | Error internal platform atau pengecualian penerimaan lain yang tidak dipetakan. |
| 503 | 050002 | Layanan sementara tidak tersedia; percobaan terbatas dapat menggunakan kunci dan body asli. |
| 504 | 050003 | Hasil penerimaan tidak diketahui; rekonsiliasi tugas asli, jangan menggunakan kunci baru. |
Kegagalan setelah diterima
Event send_failed dapat menggunakan kode platform berikut. Alasan asli penyedia berada di luar tabel ini.
| Kode | Arti | Kode | Arti |
|---|---|---|---|
141001 | Template tidak tersedia | 141010 | Kebijakan pesan ditolak |
141002 | Isi template kosong | 141011 | Konfigurasi rute tidak valid |
141003 | Variabel template transaksional hilang | 141012 | Konfigurasi kanal tidak valid |
141004 | Tidak ada rute tersedia | 141013 | Autentikasi kanal gagal |
141005 | Perakitan MIME gagal | 141014 | Snapshot runtime tidak valid |
141006 | Kanal menolak secara eksplisit | 141015 | Konfigurasi berhenti berlangganan tidak valid |
141007 | Payload tidak dapat diuraikan | 141016 | Percobaan ulang habis |
141008 | Semua penerima disupresi | 141017 | Pemrosesan internal gagal |
141009 | Domain pengirim tidak diotorisasi | 141018 | Tidak ada penerima valid |
Kode ini adalah kegagalan setelah penerimaan dan harus ditangani terpisah dari error penerimaan HTTP. Lihat API Pengiriman.
Cara menangani
Untuk pembatasan laju, tunggu setidaknya selama Retry-After. Setelah timeout, koneksi terputus, atau 5xx, periksa tugas awal sebelum mencoba ulang secara terbatas dengan X-Idempotency-Key dan body yang sama. Jangan otomatis membuat tugas baru untuk kegagalan per pesan setelah penerimaan.
Lihat ikhtisar error untuk format respons umum dan rentang kode produk lain.
Terakhir diperbarui pada