Idempotência | Kodano Docs

Idempotency-Key em todo POST que cria recurso ou move dinheiro, replay seguro e conflitos 409.

Página em construção

Este é um resumo. O conteúdo completo entra nas próximas versões da documentação; o contrato de cada rota já está na Referência da API.

Envie Idempotency-Key: <uuid> em todo POST que cria recurso ou move dinheiro. Ausente ou fora do formato UUID: 422 IDEMPOTENCY.KEY_REQUIRED.
A chave vale por 24 horas. Repetir a chamada com a mesma chave e o mesmo corpo devolve a resposta original (status, corpo e Location) com X-Idempotent-Replay: true.
Mesma chave com corpo ou rota diferente: 409 IDEMPOTENCY.CONFLICT.
Mesma chave enquanto a primeira chamada ainda está em curso: 409 IDEMPOTENCY.IN_PROGRESS com Retry-After: 2 e resourceId.
Em erro de rede ou 503, repita com a mesma chave. Gere uma chave nova só para uma operação nova.