Idempotência

Envie um header Idempotency-Key único em cada operação pública de escrita. Use um UUID ou outro valor opaco que identifique uma única ação de negócio pretendida.

Idempotency-Key: 9d4cba7f-7459-4cc7-86ee-4c37f7a2f17a

Se uma falha de rede deixar o resultado incerto, repita o mesmo método e caminho com a mesma chave e o mesmo corpo. A Morus pode repetir a resposta original e retorna:

Idempotent-Replay: true

Não reutilize uma chave com outro corpo ou para outra ação. Essa requisição retorna 409 Conflict.

Crie uma nova chave somente quando quem chama pretende iniciar outra ação de negócio. Repetições automáticas devem manter a chave original após estouros de tempo e respostas temporárias 5xx.