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
POST / GET /api/v1/mail/*
Ringkasan
Kirim dari domain sendiri melalui server; kuota, biaya, dan batas sama dengan konsol tanpa aturan kedua.
Aktifkan pengiriman email di konsol dan daftarkan setidaknya satu domain yang berstatus Live. Pengiriman dari domain yang belum live akan ditolak.
Autentikasi
Kunci tingkat akun sama dengan platform; buat di Alat & Pengaturan → Pengelolaan API.
Konsol → Alat & Pengaturan → Pengelolaan API → Buat. Kunci sama untuk energi/kartu/email/kurs, sesuai kemampuan yang diberikan.
Kirim email
POST /api/v1/mail/send
Domain From harus persis domain pengirim tertaut dan Live.
Batas pengiriman
- Total to + cc + bcc maksimal 50
- 5 MiB per email termasuk lampiran, diukur setelah decoding
- 998 karakter, bukan byte; subjek non-ASCII tidak terpengaruh
- Maksimal 32 lampiran; inline wajib content_id
- Header kustom total 16 KB, 2048 byte per nilai
Respons
Hasil dikelompokkan per penerima, bukan satu sukses keseluruhan.
Lima penerima bisa 2 delivered, 1 queued, 2 hard-bounced. bounced_addrs satu-satunya sumber kebersihan daftar; tidak ada bounce webhook. Jika diabaikan, hilang dan Anda tetap mengirim serta membayar alamat mati.
Idempotensi
Idempotency-Key memastikan kunci sama hanya sekali kirim.
Setiap coba ulang otomatis: timeout, antrean, SDK. Tanpa kunci, gangguan jaringan dapat mengirim dan menagih dua kali tanpa dapat dibatalkan. Gunakan kunci bisnis seperti nomor pesanan.
Utas email
Balasan menyertakan in_reply_to dan references agar di percakapan asal. Tanpa keduanya, balasan jadi utas baru. Kirim semua references; in_reply_to saja bisa memisahkan utas lebih dari dua pesan di beberapa klien.
Kuota & domain
Periksa kuota harian dan domain tersedia untuk batas laju di sisi Anda.
Contoh kode
Contoh minimal tiap bahasa, dengan idempotensi dan hard bounce.
Pengiriman email berbiaya. Kunci baru wajib tanda tangan bawaan, jadi contoh memakai v2 dengan X-Sign-Version: 2. Teks 7 baris dipisah \n tanpa newline akhir: NEXCORE-HMAC-SHA256-V2, timestamp, nonce, metode huruf besar, path, query, hash SHA-256 heksadesimal kecil badan. X-Signature = HMAC-SHA256(Secret Key, teks) heksadesimal kecil. timestamp unix detik, nonce maksimal 64 byte, query tanpa "?" awal persis yang dikirim (baris kosong jika tidak ada), hash badan dari byte persis. Jika sakelar wajib dimatikan, X-API-Key + X-Secret-Key bisa, tetapi tidak disarankan.
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 · API SMTP terpadu · Menggunakan API agregasi SMTP
Memuat…