Reproduzir uma chamada em uma ferramenta de teste pode mostrar detalhes que o log do sistema não registra. O resultado só ajuda a localizar a falha quando a comparação considera a requisição, a credencial, o ambiente, a máquina e o momento do teste.
O que a ferramenta mostra
O Postman monta uma requisição com o método, a URL, os cabeçalhos e o corpo e mostra o status, os cabeçalhos, o conteúdo e o tempo da resposta. A ferramenta também envia mensagens SOAP, com XML, e operações GraphQL. Três recursos organizam o trabalho:
- Coleção: um conjunto de requisições salvas, organizadas por assunto ou por fornecedor.
- Ambiente: um conjunto de variáveis, como o endereço base e o token, que separa a homologação da produção.
- Encadeamento: o uso de um valor obtido em uma chamada, como o token, nas chamadas seguintes.
O Insomnia e o SoapUI oferecem recursos parecidos, e o SoapUI é voltado aos serviços SOAP. O curl faz as mesmas chamadas pela linha de comando e já vem instalado nas versões atuais do Windows.
O curl na linha de comando
No PowerShell do Windows, a palavra curl pode ser um apelido de outro comando, com outras opções. O nome curl.exe chama o programa curl de fato. As opções mais úteis no suporte são estas:
-v: mostra as etapas da chamada, da resolução do nome até os cabeçalhos da resposta;-i: inclui os cabeçalhos da resposta na saída;-H "Nome: valor": acrescenta um cabeçalho, como o Authorization;-X POST: define o método da requisição;-d @cobranca.json: envia como corpo o conteúdo do arquivo indicado;--connect-timeout 10: limita a espera da conexão a 10 segundos;--max-time 30: limita a operação inteira a 30 segundos.
Uma consulta completa junta várias opções:
curl.exe -v -H "Authorization: Bearer <token>" https://api.example.com/v1/pagamentos/PAG-0001: consulta a cobrança PAG-0001 no gateway de pagamento e mostra as etapas da conexão.
A saída da opção -v mostra os cabeçalhos enviados, inclusive o Authorization. Por isso, o token fica mascarado antes de a saída ser compartilhada.
Chamadas com efeito real
A ferramenta envia a requisição ao endereço configurado, e uma operação de criação, alteração ou cancelamento em produção produz efeitos reais, como uma cobrança de verdade. O método, sozinho, não indica o efeito, porque um POST também pode ser uma consulta, conforme o contrato.
A reprodução de alterações usa a homologação e as credenciais de teste. Em produção, até as consultas seguem o procedimento autorizado da empresa e do fornecedor. Uma coleção com credenciais ou com dados reais de clientes também não circula fora dos ambientes aprovados.
A comparação com o sistema
A comparação entre o teste e o sistema confere o método, a URL, o corpo, os cabeçalhos, o token, o certificado, o proxy e a máquina que executa a chamada. A ferramenta pode usar outro caminho de rede, outra biblioteca de TLS e outro repositório de certificados. O intervalo entre os testes também pode coincidir com uma recuperação do serviço.
Quando a ferramenta funciona e o sistema falha, a investigação procura as diferenças entre as duas chamadas. Quando as duas falham, uma condição comum ganha força, mas o fornecedor não fica comprovado como causa, porque os dados, a credencial, a rede e o próprio procedimento de teste podem ser comuns às duas.
No suporte
Em um teste comparativo, convém registrar o que foi comparado e quais condições foram diferentes. Uma reprodução controlada reduz as hipóteses, e resultados obtidos com credenciais, máquinas ou ambientes diferentes não valem como a mesma chamada.
Para guardar
- As ferramentas de teste enviam chamadas reais e mostram os detalhes da resposta.
- No Windows, o
curl.exechama o programa curl, e a opção-vmostra as etapas da chamada. - A homologação e a produção usam endereços e credenciais separados.
- Uma comparação útil observa as diferenças entre o teste e o sistema, sem atribuir a causa automaticamente.
A chamada funciona no Postman e falha no sistema da loja. Isso confirma um defeito no sistema?
Não. A montagem da chamada, o token, o certificado, a rede, a máquina e o horário podem ser diferentes. O sucesso na ferramenta mostra que aquela reprodução funcionou, e não que as condições eram iguais.
Uma coleção marcada como teste usa a URL e o token de produção. Os efeitos ficam limitados à homologação?
Não. O endereço e a credencial efetivos definem o ambiente atendido. As variáveis resolvidas são conferidas antes de qualquer chamada, conforme o procedimento autorizado.