Causa: Código mistura timeout, 401, 404 e 500
Melhoria: Mapeie cada classe para ação: autenticar, corrigir entrada, tentar depois ou abrir incidente.
Uma requisição HTTP por dentro
Método, URL, headers, body e status sem caixa-preta
Objetivo
Montar uma requisição completa, prever a resposta e separar falha de rede, erro do cliente e erro do servidor.
História
O aplicativo precisa abrir a OS 742. O navegador não consulta o PostgreSQL: ele envia uma mensagem HTTP à API. A API autentica, autoriza, consulta o domínio e devolve uma representação. O laboratório torna cada fronteira visível.
Hipótese a testar
Aumentar o tamanho do body não cria mais requisições; aumenta os bytes de uma requisição. Mudar GET para POST altera a intenção e pode alterar cache, idempotência e autorização.
Pré-requisitos
- URL
- cliente e servidor
- JSON básico
Simulador
Altere uma variável, antecipe o efeito e compare com o indicador. A escala mostra pressão relativa, não uma garantia de segurança.
Faixa controladaReveja o contrato e os testes antes de concluir.
Fluxo observado
- Aplicativo
- DNS + TLS
- API
- autorização
- domínio
- resposta HTTP
O que observar
- Método expressa a semântica pretendida; não é um comando do banco.
- Status descreve o resultado da requisição, não toda a saúde do processo empresarial.
- Um 200 pode esconder sincronização pendente; o body precisa representar esse estado.
Erros comuns e melhoria
Causa: Retry de POST sem chave de idempotência
Melhoria: Envie uma chave estável e faça o servidor registrar o primeiro resultado.
Exercício guiado
- Escreva uma chamada GET /ordens/742 com Accept e Authorization.
- Preveja respostas para token expirado, OS inexistente e banco indisponível.
- Compare sua previsão com o simulador e explique a primeira divergência.
Desafio independente
Desenhe o contrato para concluir a OS quando o ERP estiver fora. O HTTP pode responder sucesso parcial? Qual estado o usuário precisa ver?
Evidência exigida
Uma tabela com requisição, resposta esperada, resposta observada e decisão para cinco cenários, incluindo timeout.