Ves a la documentació
API

Idempotència

Fer que un reintent sigui segur.

Com funciona

Envieu Idempotency-Key a POST /emails, POST /emails/batch o POST /templates/{id}/send. Cap altra ruta no la llegeix. La primera crida fa la feina, i una repetició amb la mateixa clau retorna el missatge idèntic. POST /emails també estableix Idempotency-Replayed: true, mentre que el lot informa de replayed a cada element i l'enviament de plantilla ho informa al cos i respon 200 en lloc de 202. La reserva de la clau es fa amb la inserció mateixa a la base de dades, de manera que dues peticions que competeixin amb la mateixa clau no poden guanyar totes dues.

Capçalera
Idempotency-Key: invoice-8812

Reutilitzar una clau amb un cos diferent és un 422 idempotency_key_reuse i no una reproducció silenciosa. Gairebé sempre vol dir que la clau s'ha derivat d'alguna cosa que no és prou única, i tornar a servir a algú un missatge que no ha enviat és pitjor que rebutjar-ho.

En un lot la clau s'amplia per element, de manera que una sola clau per a cent missatges no els col·lapsa tots en el primer.