Dokumentasi API pengiriman

Satu API untuk mengirim email pendaftaran, reset kata sandi, dan notifikasi dari situs Anda — tanpa SMTP.

Tersedia sekarang Kepemilikan, MX, SPF, DKIM, dan DMARC diverifikasi terpisah. Setelah siap, kirim dengan API key dan pantau di dasbor hasil per penerima: terkirim, gagal, dan tertunda.

Mulai cepat

  1. 1

    Hubungkan domain

    Tambahkan domain pengiriman di Pengiriman situs.

  2. 2

    Verifikasi DNS

    Tambahkan catatan SPF / DKIM / DMARC dan TXT verifikasi, lalu verifikasi sekali klik.

  3. 3

    Buat kunci

    Buat kunci te_live_ — teks hanya tampil sekali, jadi simpan saat itu.

Kirim email

Permintaan POST dengan kunci te_live_ di header Authorization.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Kolom permintaan

from Alamat pengirim, harus di domain terverifikasi
to Alamat penerima (tunggal atau array)
subject Subjek email
html / text Isi email (HTML atau teks biasa)
Idempotency-Key Header opsional; gunakan ulang nilai saat retry untuk mencegah kirim ganda

Permintaan yang diterima mengembalikan HTTP 202 dengan id dan status accepted. Dengan kunci sama, GET /api/sending/messages/{id} mengembalikan per penerima: terkirim, gagal, tertunda, atau tidak diketahui.

Error & batas

401 Kunci tidak valid atau dicabut — buat ulang kunci te_live_
403 Domain pengirim belum diverifikasi, atau alamat bukan di domain terverifikasi
429 Laju kirim terlampaui; respons berisi retry_after — coba lagi nanti sesuai petunjuk
503 Mesin email sementara tak tersedia; coba lagi dengan Idempotency-Key sama

Jumlah penerima, ukuran isi, dan laju memiliki batas pelindung. Penggunaan dihitung hanya setelah validasi, jadi permintaan tidak valid tak menghabiskan kuota.