MailnationDocs

Idempotency

Header Idempotency-Key wajib di POST /emails. TTL 24 jam.

Retry yang aman: kirim ulang header dan body yang sama.

  • Scope: (account_id, credential_id, key)
  • Panjang 1–255, tanpa karakter kontrol
  • Hash body: from, to, cc, bcc, reply_to, subject, html, text, headers, tags, dan isi attachment (setelah dinormalisasi)
  • TTL 24 jam
  • Body beda + key sama → 409 idempotency_conflict
  • Request masih diproses → 409 idempotency_in_progress

Lease pemrosesan 2 menit. Jika accept berhasil, retry mengembalikan respons 202 yang sama dan tidak mengirim dua kali.