Como transformar as chamadas de API do meu aplicativo em testes de API?
Grave-as enquanto usa o aplicativo, revise a lista e gere um teste a partir das chamadas que mantiver. O Nexus Recorder no Nexus StudioQA, da Verdict System LLC, grava as chamadas que uma página faz como testes REST ou GraphQL, omite os cabeçalhos de autenticação e cookies e transforma campos que parecem conter segredos em variáveis de ambiente. Tudo é executado na sua própria máquina.
Última atualização:
Pela equipe do Nexus StudioQA, Verdict System LLC.
Como funciona a gravação?
- No Nexus Recorder, grave as chamadas que a página faz enquanto você percorre um fluxo, como um login e uma finalização de compra.
- Antes de qualquer teste ser gravado, a Revisão lista cada chamada com seu método, caminho, status, categoria e o motivo de sua inclusão ou exclusão.
- Chamadas de negócio, autenticação, leitura e alteração de estado começam incluídas na suíte. Sinalizadores de telemetria, hosts de terceiros, recursos e requisições preflight começam excluídos, e você pode marcar qualquer um deles para incluí-lo.
- Os fluxos encadeiam um valor de uma resposta em uma requisição posterior, como o token retornado por um login.
O que posso gerar a partir de uma gravação?
- Gerar teste grava a suíte de testes de API.
- Gerar OpenAPI grava um rascunho OpenAPI 3.1 com tipos e códigos de status, sem nenhum dos valores gravados.
- Teste de carga abre as mesmas chamadas como um plano de carga.
O que fica fora do arquivo de teste?
| O que a gravação capturou | O que vai para o arquivo de teste |
|---|---|
| Cabeçalhos de autenticação e cookies | Omitidos |
| Campos com nomes que sugerem segredos | Uma variável de ambiente, listada em Ocultações |
| JWTs, chaves de provedores e números de cartão em qualquer campo | Ocultados pelo valor, não apenas pelo nome do campo |
| Telemetria, hosts de terceiros, recursos e requisições preflight | Excluídos por padrão |
Quando o teste é executado, seu token de autenticação é enviado apenas à origem em API_BASE_URL, nunca a outro host que apareceu na gravação.
Como os testes de API são avaliados?
Eles são executados pelo Patrol como qualquer outro teste, e cada endpoint gera sua própria pasta de evidências. Os testes de API não têm ambiente isolado: são executados de verdade já no primeiro clique. Eles recebem veredictos de API próprios: API_SECURE quando todas as asserções são satisfeitas e a estrutura da resposta corresponde à última gravada, API_FLAKY quando uma nova tentativa passa e API_DRIFTED quando o teste passa, mas a estrutura muda, com a identificação de cada campo adicionado, removido ou cujo tipo mudou. Desvio de esquema da API mostra um desvio em uma execução real.
Quais são os limites?
- Uma gravação contém apenas as chamadas que a página fez durante a gravação. Um endpoint que o fluxo nunca acessou não está nela.
- A gravação gera testes REST e GraphQL. Os testes SOAP são criados manualmente, como XML enviado em formato de texto e verificado com regras de texto.
- Os testes de API usam o formato próprio do Studio, então transferi-los para outro executor exige reescrevê-los. Os testes de navegador que o Recorder gera continuam no padrão Playwright ou Selenium.
- Revise o teste gerado antes de confiar nele: a gravação sabe o que o aplicativo fez, não o que deveria fazer.
Onde posso ver isso?
O tour pelo Studio mostra o Nexus Recorder, e Desvio de esquema da API explica os veredictos de API com um exemplo executável. A avaliação gratuita executa o mesmo mecanismo no seu próprio aplicativo.