Idempotência
A operação de criação de vínculo é idempotente. Isso significa que é seguro realizar uma nova tentativa
em caso de falhas temporárias, como erros de conexão ou término abrupto de processos. A resposta retornada
para uma requisição repetida é equivalente à resposta dada à primeira requisição processada.
Para garantir a idempotência da operação, a requisição tem um campo RequestId
. Esse campo é um
UUID
versão 4 e deve ser único no contexto de um mesmo participante. O RequestId fica associado ao
vínculo criado e é usado no cálculo do seu CID (ver seção de reconciliação na documentação).
Uma requisição de criação é considerada repetida quando o CID do vínculo contido na requisição já existe no DICT.
Caso seja feita uma requisição com um RequestId
previamente usado, mas com parâmetros diferentes para o vínculo,
será retornado o erro RequestIdAlreadyUsed
.