Tovanix
Tovanix

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…