A ideia#
Um agente planeja contra uma revisão e envia o lote inteiro. O núcleo aplica tudo ou nada, como um único passo de desfazer.
Início rápido#
- Leia a revisão com
project_get. - Planeje o lote. Dê os seus próprios ids ao que operações posteriores do mesmo lote usam.
- Envie com
base_revision. Acrescente umaidempotency_keyse a chamada puder ser repetida. - Leia o resultado:
revision,created,diffefindings.
Quando a resposta é E_REVISION_CONFLICT, o erro traz as mudanças desde a sua revisão como um diff em texto. Leia-o, planeje de novo contra a revisão nova e envie um lote novo.
Erros comuns#
- Reutilizar uma
idempotency_keypara um lote diferente:E_IDEMPOTENCY_MISMATCH. - Repetir um erro cujo
retryableé falso. Só repita quando for verdadeiro.