Idempotência com Idempotency-Key

Para garantir que operações de mutação (criação de pedidos, atualizações) não sejam executadas duas vezes caso ocorra uma queda de conexão antes da resposta do servidor, utilize o cabeçalho:

`Idempotency-Key: <UUID_V4>`

Regras de Comportamento

1. **Mesma chave + mesmo payload:** O Tarevo não reexecuta a operação e retorna imediatamente a mesma resposta HTTP (status e corpo) da chamada original com cache em banco de dados.

2. **Mesma chave + payload divergente:** O servidor retorna **HTTP 409 Conflict** protegendo a integridade semântica dos dados.

3. **Janela de retenção:** As chaves de idempotência permanecem ativas e protegidas por 24 horas.