API Surel SMTP
API pengiriman untuk email transaksional — verifikasi pendaftaran, notifikasi pesanan, pengaturan ulang kata sandi — melalui SMTP standar maupun API HTTP.
- Dua cara integrasi: gunakan klien SMTP yang sudah ada tanpa perubahan kode, atau beralih ke API HTTP untuk laporan yang lebih terperinci
- Templat: kelola templat terpusat dan kirim hanya variabel saat pengiriman
- Pengiriman massal: banyak penerima dalam satu permintaan, dengan laporan masing-masing
- Webhook pengiriman dan pantulan: peristiwa terkirim / terpental / keluhan secara waktu nyata untuk melindungi reputasi pengirim
POST / GET /api/v1/smtp/*
Ringkasan
SMTP API agregasi untuk mengirim email melalui akun Anda dengan API terpadu. Mendukung rotasi cerdas beberapa akun, failover otomatis, dan pengelolaan kuota.
Beli langganan -> Tambah akun SMTP -> Buat Kunci API -> Panggil API kirim
Autentikasi
SMTP API memakai kunci khusus modul berprefiks smk_, dengan dua metode autentikasi:
Konsol pengguna -> SMTP API agregasi -> Pengelolaan Kunci API. Simpan segera; kunci lengkap tidak terlihat lagi setelah ditutup.
Kirim Email
POST /api/v1/smtp/send
Kirim email. Sistem memilih akun terbaik menurut prioritas, penggunaan, dan kesehatan.
Kolom Respons
Header Idempotency-Key untuk coba ulang aman: hasil pertama berhasil dicache, kunci sama mengembalikan hasil itu tanpa kirim atau potong kuota lagi.
Respons Kirim Terjadwal
send_at di masa depan membuat tugas, bukan langsung mengirim; struktur berikut dikembalikan dan kuota dipotong saat benar-benar dikirim:
code: 429 jika batas harian/bulanan habis. Tingkatkan atau tunggu reset.
Kirim Massal
POST /api/v1/smtp/send/batch
Kolom Respons
Batas penerima = max_batch_size paket, bawaan 10; kelebihan langsung gagal. Kuota dipotong per email, bukan permintaan; penerima berhenti berlangganan ditandai gagal. Batch besar memakan waktu dan permintaan bisa habis waktu sebelum ada balasan: kirim header Idempotency-Key; mencoba ulang dengan nilai yang sama mengembalikan hasil pertama, bukan mengirim ulang seluruh batch.
Kirim Templat
POST /api/v1/smtp/send/template
Kolom Respons
Templat mendukung idempotensi persisten: header Idempotency-Key: <unique-string>. Intent disimpan berdasarkan pengguna + API Key + kunci, bertahan setelah restart atau Redis hilang. (1) Kunci dan isi sama mengembalikan hasil asli tanpa kirim/kuota ulang; (2) kunci sama, isi berbeda: 409, gunakan baru; (3) permintaan pertama pending: 409, coba nanti dengan kunci sama; (4) intent gagal tidak dapat dibuka ulang: 409, mulai dengan kunci baru. Tanpa header, kirim biasa tanpa idempotensi.
Kueri Kuota
GET /api/v1/smtp/quota
Kueri sisa kuota langganan.
Kueri Status Kirim
GET /api/v1/smtp/status/:message_id
Kueri melalui message_id dari API kirim.
Laporan Bounce/Keluhan
POST /api/v1/smtp/inbound
Laporkan bounce/keluhan: alamat masuk daftar penekanan dan log terkait ditandai; pengiriman berikut melewati untuk menjaga reputasi. Wajib email atau message_id.
Pertanyaan umum
Kami sudah memakai SMTP — apakah perlu menulis ulang kode?
Tidak. Arahkan klien SMTP yang ada ke host, port, dan kredensial yang diberikan Tovanix. Beralih ke API HTTP hanya jika Anda memerlukan laporan pengiriman dan pantulan yang lebih terperinci.
Bagaimana menangani pantulan dan keluhan?
Keduanya dikirim kepada Anda secara waktu nyata melalui webhook. Masukkan alamat ke daftar larangan pengiriman dan segera hentikan pengiriman ke alamat tersebut untuk membantu melindungi reputasi domain pengirim.
Halaman terkait: API SMTP terpadu · Dokumentasi API · Verifikasi SMS
Memuat…