Idempotentie

Stuur Idempotency-Key mee op POST /emails, POST /emails/batch of POST /templates/{id}/send. Geen enkele andere route leest hem. De eerste aanroep doet het werk, en een herhaling met dezelfde sleutel geeft hetzelfde bericht terug. POST /emails zet daarnaast Idempotency-Replayed: true, terwijl de batch replayed per item meldt en de template-verzending het op de body meldt en met 200 antwoordt in plaats van 202. De claim wordt gelegd als de database-insert zelf, dus twee verzoeken die met dezelfde sleutel racen kunnen niet allebei winnen.

Idempotency-Key: invoice-8812

Een sleutel hergebruiken met een andere body levert een 422 idempotency_key_reuse op in plaats van een stille herhaling. Het betekent bijna altijd dat de sleutel is afgeleid van iets dat niet uniek genoeg is, en iemand een bericht terugspelen dat hij niet heeft verstuurd is erger dan weigeren.