Resource inti
POST /v1/emails — mengantrekan pesan GET /v1/emails/{id} — memeriksa status pesan
REST API
REST API
Kirim dengan satu permintaan JSON.
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.
Model akses saat ini
Kunci saat ini memakai srs_live_. Sebelum domain From diverifikasi, pengirim sandbox bersama hanya dapat mengirim ke anggota proyek. Setelah itu kuota, suppression, batas penerima, dan kontrol abuse tetap berlaku. 202 berarti masuk antrean, bukan terkirim.
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>"
}