Autentikasi
Kirim kunci srs_live_ scoped dari dasbor sebagai token Bearer. Setiap kunci punya scope sendiri (emails:send, webhooks:write …); kunci yang dicabut atau kedaluwarsa ditolak dengan 401.
POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json
{
"from": "Sender Name <info@example.com>",
"to": ["user@example.net"],
"subject": "Reset your password",
"html": "<p>Click to reset your password.</p>"
}Resource inti
- POST /v1/emails — mengantrekan satu pesan
- POST /v1/emails/batch — hingga 100 pesan per permintaan
- GET /v1/emails — daftar pesan terbaru
- GET /v1/emails/{id} — status pesan
- DELETE /v1/emails/{id}/schedule — membatalkan pengiriman terjadwal
Model respons
202 berarti diantrekan, bukan masuk inbox. 403 dapat mengindikasikan scope yang hilang atau domain yang belum terverifikasi. 422 memblokir penerima yang di-suppress. 429 mengindikasikan rate limiting.
Batas layanan saat ini
API REST menolak lampiran. Hanya header khusus In-Reply-To, References, List-Unsubscribe dan List-Unsubscribe-Post yang diterima (maksimal 8). Email terkelola terpisah: klien web menerima 20 lampiran, total 25 MiB; klien desktop yang dirilis membatasi pengiriman 10 MiB. HTTP 202 dan email.accepted berarti diterima untuk diproses; penerimaan SMTP tidak menjamin pengiriman atau masuk ke kotak masuk.