Pesan error umum
Ketika permintaan gagal, Bird mengembalikan respons kesalahan terstruktur berisi kode yang dapat dibaca mesin, pesan, tautan dokumentasi, dan request ID. Gunakan kode tersebut dalam logika program. Jika Anda membutuhkan bantuan, pilih Feedback > Contact us dan sertakan request ID. Untuk katalog lengkap, lihat Referensi error API.
Error validasi
Error ini berarti Bird memahami permintaan Anda, tetapi ada sesuatu di dalamnya yang tidak dapat diterima. Error mencantumkan field atau kondisi spesifik yang bermasalah.
Semua penerima di-suppress
Artinya: setiap penerima dalam pengiriman Anda ada di daftar supresi, sehingga tidak ada yang tersisa untuk dikirim dan pengiriman ditolak.
Kemungkinan penyebab: Anda mengirim ke alamat yang sebelumnya hard-bounce, melaporkan keluhan, atau berhenti berlangganan, sering kali tanda bahwa Anda mengirim ulang ke daftar lama atau belum dibersihkan. Jika hanya sebagian penerima yang di-suppress, pengiriman tetap berjalan untuk sisanya dan penerima yang di-suppress ditampilkan sebagai ditolak; error ini hanya muncul ketika semuanya di-suppress.
Cara mengatasinya: periksa alamat mana yang di-suppress beserta alasannya, lalu hapus dari daftar Anda. Mengapa email saya ditolak? menjelaskan bagaimana penolakan supresi ditampilkan, dan panduan supresi membahas pengelolaan daftar tersebut.
Penerima onboarding tidak diizinkan
Artinya: Anda mengirim dari domain onboarding bersama Bird ke seseorang yang bukan anggota terverifikasi workspace Anda.
Kemungkinan penyebab: domain bersama hanya mengirim ke anggota workspace yang terverifikasi dan alamat uji sandbox.
Cara mengatasinya: untuk mengirim email ke penerima sesungguhnya, verifikasi domain pengiriman Anda sendiri, yang akan menghapus pembatasan sepenuhnya. Lihat Mengirim dari domain bersama untuk batasan dan cara mengatasinya.
Field tidak ada atau tidak valid
Artinya: field wajib tidak ada, nilainya tidak valid, atau permintaan menggabungkan field yang tidak kompatibel.
Kemungkinan penyebab: permintaan tidak sesuai dengan skema operasi atau menggabungkan field yang tidak kompatibel. Detail error mengidentifikasi setiap field yang gagal.
Cara mengatasinya: baca detail error dan perbaiki field yang disebutkan.
Error pembatasan laju permintaan
Artinya: permintaan melebihi batas operasi, akun, atau pengiriman.
Kemungkinan penyebab: lonjakan melebihi batas laju permintaan API, atau pengiriman melebihi kuota seperti batas penerima domain onboarding bersama.
Cara mengatasinya: ikuti remediasi error dan nilai Retry-After jika tersedia. Coba lagi batas sementara dengan backoff. Untuk batas harian onboarding, tunggu reset hari UTC atau verifikasi domain pengiriman Anda sendiri. Label kesehatan email throttled bersifat diagnostik dan tidak menyebabkan error pembatasan laju permintaan API.
Error autentikasi
Artinya: Bird tidak dapat menerima kredensial Anda.
Kemungkinan penyebab: salah satu dari tiga hal berikut, diurutkan berdasarkan frekuensi:
- Kunci API salah, kedaluwarsa, atau dicabut: kunci salah ketik, terpotong, kedaluwarsa, atau sudah tidak aktif. Secret hanya ditampilkan saat kunci dibuat atau dirotasi.
- Kunci digunakan untuk region yang salah: kunci API bersifat regional, dan kunci hanya berfungsi di server regionnya sendiri. Jika kunci Anda dibuat di satu region tetapi kode Anda memanggil region lain, autentikasi gagal. Prefiks kunci menunjukkan region mana kunci tersebut.
- Kunci tidak ada: permintaan tidak menyertakan kredensial sama sekali, sering kali karena variabel lingkungan kosong di environment yang bermasalah.
Cara mengatasinya: pastikan kunci ada dan aktif di dashboard Anda, kode Anda mengirimnya, dan Anda memanggil alamat regional yang sesuai dengan kunci tersebut. Jika ragu, buat kunci baru dan gunakan sebagai pengganti.
Domain belum diverifikasi
Artinya: domain pengiriman belum menyelesaikan verifikasi, sehingga Bird tidak dapat mengirim dari domain tersebut.
Kemungkinan penyebab: record DNS tidak ada, masih dalam propagasi, atau salah, atau record berubah setelah verifikasi. Lihat checklist verifikasi domain untuk perkiraan waktu.
Cara mengatasinya: buka halaman domain di dashboard untuk mengidentifikasi record yang belum lengkap. Gunakan checklist verifikasi domain untuk memperbaikinya. Selama DNS masih propagasi, gunakan domain onboarding bersama untuk pengiriman uji.
Membaca error apa pun yang Anda temui
Cocokkan berdasarkan kode error yang dapat dibaca mesin karena pesan untuk manusia bisa berubah. Catat request ID. Jika Anda membutuhkan bantuan, pilih Feedback > Contact us dan sertakan request ID tersebut. Ikuti tautan dokumentasi untuk remediasi spesifik error.
Langkah selanjutnya
- Referensi error API (katalog lengkap: setiap tipe error, kode, dan status)
- Mengapa email saya ditolak?: alasan di balik penolakan per penerima
- Mengapa kesehatan email menampilkan Throttled?: label kesehatan diagnostik dan sinyal di baliknya
- Mengirim dari domain bersama: batasan penerima dan batas harian domain onboarding
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaWhat happens when someone opts outPahami konsepnyaWhat is one-click unsubscribe, and how do I implement List-Unsubscribe?Jelajahi kemampuannyaEmail opt-outsIkuti jalur pembelajaranOperate messaging reliably
Dapatkan ringkasan implementasi