API Pengiriman Email
Kirim dari domain sendiri melalui server, dengan kuota, tagihan, dan batas yang sama seperti pengiriman dari konsol. Domain pengirim harus tepat cocok dengan domain pengiriman yang terhubung dan aktif.
- Autentikasi: kunci API tingkat pengguna yang digunakan antarmuka API terbuka terkait pada platform
- Pengiriman: POST /api/v1/mail/send; respons dikelompokkan per penerima dan bounced_addrs menjadi acuan pembersihan daftar
- Idempotensi: header Idempotency-Key membuat pengajuan ulang kunci yang sama hanya mengirim sekali, tanpa pengiriman atau tagihan ganda
- Percakapan: kirim in_reply_to dan seluruh rantai references agar balasan masuk ke percakapan asli penerima
- Kuota dan domain: periksa kuota tersisa hari ini dan domain yang dapat dipakai untuk membatasi laju pada sistem sendiri
- Contoh kode: cURL / Node.js / Python / Go / PHP minimal yang dapat dijalankan, dengan idempotensi dan penanganan pantulan permanen
Pertanyaan umum
Apakah HTTP 200 berarti semua penerima mendapat email?
Tidak. Hasil dikelompokkan per penerima: pesan untuk lima orang dapat berisi 2 terkirim, 1 mengantre, dan 2 terpental permanen. Tidak ada webhook pantulan, sehingga bounced_addrs adalah satu-satunya acuan pembersihan daftar; segera hentikan pengiriman ke alamat tersebut.
Kapan Idempotency-Key diperlukan?
Saat panggilan dapat mencoba ulang otomatis, misalnya batas waktu, pengiriman ulang antrean tugas, atau percobaan ulang bawaan SDK. Tanpanya, gangguan jaringan dapat mengirim dua email dan menagih dua kali, tanpa dapat dibatalkan. Gunakan kunci bisnis seperti ID pesanan.
Halaman terkait: Dokumentasi API Tovanix · API Email SMTP · Dukungan Pengiriman Email · Menggunakan API agregasi SMTP
Memuat…