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
- Leia o contrato do endpoint. Verifique se
202significa 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ê. - 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”.
- 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.
- Separe estado da operação e resultado de negócio. No exemplo de cópia do Graph, o monitor passa de
inProgressparacompletede 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. - 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.