Idempotência e versões

Repetir uma chamada não duplica nada, e duas edições ao mesmo tempo não se atropelam.

Mensagens: client_id

O envio de mensagem (POST /conversations/{id}/messages) exige client_id, um UUID escolhido por você. Repetir a chamada com o mesmo client_id devolve a mensagem já criada, sem enviar de novo ao cliente. Gere um client_id por mensagem e guarde-o junto do registro no seu sistema.

Kanban: Idempotency-Key

No Kanban, todo POST exige Idempotency-Key, com 8 a 128 caracteres, única por operação. Se a mesma chamada for repetida (mesma chave, mesmo caminho e mesmo corpo), a resposta volta com Idempotency-Replayed: true. A chave fica reservada por 7 dias; a mesma chave com outro corpo devolve 409.

Se a conexão cair depois da execução e antes de a resposta ser guardada, a reserva fica pendente e a repetição recebe 409 sem executar de novo. Confira o estado do cartão antes de tentar com uma chave nova.

Kanban: versões

Editar (PATCH) e mover um cartão exigem version no corpo ou o cabeçalho If-Match: "v1". Sem versão a resposta é 428; com versão antiga, 409 com code: version_conflict.