Idempotência

Envie Idempotency-Key em POST /emails, POST /emails/batch ou POST /templates/{id}/send. Mais nenhuma rota a lê. A primeira chamada faz o trabalho, e uma repetição com a mesma chave devolve a mensagem idêntica. POST /emails define também Idempotency-Replayed: true, enquanto o lote reporta replayed em cada item e o envio de template reporta-o no corpo e responde 200 em vez de 202. A reivindicação é feita pela própria inserção na base de dados, pelo que dois pedidos em corrida com a mesma chave não podem ganhar ambos.

Idempotency-Key: invoice-8812

Reutilizar uma chave com um corpo diferente dá um 422 idempotency_key_reuse em vez de uma repetição silenciosa. Quase sempre significa que a chave foi derivada de algo que não é suficientemente único, e reproduzir a alguém uma mensagem que essa pessoa não enviou é pior do que recusar.