workflows

HTTP 202 na automação: o que verificar antes do próximo passo

Uma API aceitou a operação, mas o trabalho pode continuar pendente. Veja como acompanhar o estado final e decidir quando liberar a ação seguinte.

Uma resposta 202 Accepted indica que a API aceitou a solicitação para processamento. Ela não confirma que o trabalho terminou. Se a próxima etapa depende do resultado, guarde a referência da operação, acompanhe o estado pelo caminho documentado e só libere a etapa dependente após uma conclusão confirmada.

Resposta curta

No Microsoft Graph, certas ações demoradas devolvem 202 e um cabeçalho Location para consultar o andamento. O monitor pode indicar que a ação ainda está em curso; o resultado só vem depois. No Azure Automation, o webhook pode aceitar a solicitação e devolver um identificador de trabalho que foi colocado na fila. Esses são contratos específicos: confira o endpoint usado antes de assumir que ele oferece Location, webhook de conclusão ou os mesmos nomes de estado.

Ficha de liberação da próxima etapa

Situação observada Evidência a guardar Decisão para a etapa dependente
Aceita, ainda sem estado final ID da operação e caminho de consulta documentado Aguardar; não marcar como concluída nem reenviar automaticamente
Em curso Estado e horário da última consulta; cadência indicada pelo provedor Aguardar sem consultas excessivas
Concluída com sucesso Estado terminal e, quando houver, localização ou leitura do resultado Conferir o resultado necessário e então liberar a próxima ação
Concluída com falha Estado terminal, código e mensagem sem segredos Parar a dependência; corrigir a causa antes de novo pedido
Estado indeterminado Última resposta, ID e prazo operacional definido pela equipe Interromper a sequência e investigar; não presumir sucesso nem repetir uma ação com efeito possível

Esta ficha é um modelo editorial da Pulse, não um recurso da Microsoft. Registre apenas os dados necessários. No exemplo de cópia do Graph, a URL do monitor é única, curta e pode ser consultada sem autenticação: trate-a como acesso sensível, guarde-a em local restrito e mostre apenas uma referência segura no painel. Não copie tokens, documentos pessoais ou corpos completos.

Como acompanhar sem duplicar o trabalho

  1. Leia o contrato do endpoint. Verifique se 202 significa trabalho enfileirado e identifique onde o provedor informa o ID e o monitor. Algumas operações podem responder de forma síncrona; um fluxo deve tratar essa alternativa quando o contrato a prevê.
  2. Guarde a correlação. Vincule o pedido original ao ID da operação. Não crie um segundo pedido apenas porque a primeira consulta ainda mostra “em curso”.
  3. Consulte pelo método previsto. Use o monitor, evento final ou consulta de recurso descritos pelo provedor. Respeite a cadência indicada. Se o monitor expirar ou não responder, trate o resultado como indeterminado até obter evidência confiável.
  4. Separe estado da operação e resultado de negócio. No exemplo de cópia do Graph, o monitor passa de inProgress para completed e devolve o ID da cópia; a aplicação ainda pode ler o recurso criado. Outros endpoints têm estados próprios, inclusive falha. Use o contrato daquele endpoint para decidir qual estado é final.
  5. Libere ou pare. Só dispare a etapa seguinte quando o estado e o resultado exigidos estiverem confirmados. Falha e indeterminação seguem uma rota de correção ou revisão humana.

Exemplo brasileiro: atualização de variações no Mercado Livre

Para vendedores habilitados ao modelo correspondente, a documentação de preço por variação do Mercado Livre mostra uma atualização assíncrona que devolve 202, task_id e pending. O resultado é consultado pelo recurso de tarefas; a resposta pode distinguir itens ainda pendentes, bem-sucedidos e com falha. Antes de anunciar que todas as variações de um anúncio foram atualizadas, a equipe deve consultar a tarefa e conferir os itens necessários. Este é um exemplo documental, não uma operação realizada pela Pulse. A disponibilidade do modelo é progressiva, portanto confirme a habilitação da conta e o contrato atual antes de implementar.

Quando este protocolo não basta

Se a API não oferece forma confiável de consultar o trabalho e uma repetição pode criar dois registros, não automatize o reenvio. Defina uma fonte de verdade e uma etapa manual antes de continuar. Se o contrato apresentar sucesso parcial em um lote, use a ficha por item do lote. Se o 202 vier de um webhook do Make, consulte a fila e o processamento específicos do Make. Para reenvios de eventos, trate também ações duplicadas.

Fontes