Um cenário de teste nos testes do Apidog serve como a unidade fundamental, análoga a uma Collection no Postman. Quando você precisar enviar várias requisições consecutivamente, criar cenários de teste contínuos ou repetir requisições com diferentes dados de teste, poderá criar um cenário de teste e adicionar a ele as requisições necessárias.Benefícios dos cenários de teste#
Usando cenários de teste no Apidog, você pode atender com eficiência a uma variedade de requisitos de teste de API:| Recurso | Descrição |
|---|
| Execução sequencial de requisições | Organize e execute várias requisições em uma ordem especificada para simular interações de usuários ou fluxos de processo |
| Relatórios de teste | Gere automaticamente relatórios que fornecem visualizações detalhadas de assertivas e resultados de requisições individuais |
| Integração com CI/CD | Integre cenários de teste a pipelines de CI/CD para garantir testes automáticos durante os ciclos de desenvolvimento, facilitando a detecção antecipada de problemas |
| Teste de desempenho | Avalie o desempenho da API sob cargas variadas e gere análises de tendência para identificar alterações nos comportamentos de resposta ao longo do tempo |
| Teste de parâmetros dinâmicos | Execute requisições várias vezes usando parâmetros gerados dinamicamente para testar como a API lida com entradas variáveis |
| Dados de teste predefinidos | Utilize dados predefinidos para requisições a fim de simular condições operacionais realistas e verificar as respostas da API em relação às saídas esperadas |
| Passagem de dados entre requisições | Passe automaticamente dados da saída de uma requisição para outra, o que é crucial para testar APIs que exigem persistência de estado entre chamadas |
| Relações lógicas de requisições | Configure condições lógicas, como if, for e foreach, para gerenciar o fluxo de execução com base nos resultados de requisições anteriores ou em condições específicas |
Esses recursos permitem que você crie ambientes de teste versáteis e eficazes, que contribuem para um desenvolvimento de API robusto e de alta qualidade.Criando um cenário de teste#
Ao abrir o Apidog, navegue até o módulo "Tests" e, em seguida, clique no + ao lado da barra de pesquisa para criar um novo cenário de teste. Selecione o diretório apropriado para ele e defina a prioridade para concluir a criação.Adicionando etapas de teste#
Depois de configurar seu cenário de teste no Apidog, você pode começar a preenchê-lo com requisições. Há várias maneiras de adicionar requisições, cada uma adaptada a diferentes necessidades e níveis de flexibilidade:Requisições vinculadas à especificação do endpoint#
Essas requisições podem ser atualizadas conforme a especificação do endpoint muda:Importar da especificação do endpoint#
Você pode importar especificações de endpoints do projeto atual como etapas no cenário de teste. Há dois modos ao importar endpoints: "Manual" e "Automated". Para obter instruções mais detalhadas, consulte Sincronizar dados de endpoints/casos de endpoint.No modo "Manual", modificações na documentação do endpoint dentro do projeto não têm impacto imediato nos endpoints nas etapas de teste. A sincronização dos dados de teste ocorre somente quando os testadores ativam o botão "Manual". É importante observar que alterações feitas nos dados da etapa de teste não atualizarão a documentação do endpoint, mesmo ao clicar em "Manual Sync". Em vez disso, clicar nesse botão permite que os cenários de teste recuperem informações da documentação do endpoint para fins de sincronização.No modo "Automated", quaisquer alterações na documentação do endpoint dentro do projeto serão atualizadas de forma síncrona nas etapas de teste.Importar de um caso de endpoint#
Você pode optar por importar casos de endpoint do projeto atual ou de outros projetos. Há dois modos ao importar casos de endpoint: "Copy" e "Reference".Ao importar um caso de endpoint como "Copy", os parâmetros no caso de endpoint também serão copiados para as etapas de teste. Eles serão independentes entre si, e alterações em cada um não afetarão os demais. A sincronização manual pode ser selecionada.Ao importar um caso de endpoint como "Reference", ele usará diretamente o caso de endpoint do projeto original para a requisição.Se a etapa de teste for referenciada a partir de um caso, você verá um aviso indicando que modificar essa etapa também afetará o caso de endpoint original e quaisquer outras etapas que o utilizem.Requisições independentes não associadas à especificação da API#
Essas requisições não são atualizadas em resposta a alterações na especificação da API. Elas permitem maior personalização:Adicionar requisição personalizada#
Em um processo de trabalho, você pode precisar chamar um endpoint fora do projeto, como um endpoint de pagamento de terceiros.Você pode adicionar uma requisição de API personalizada nas etapas de teste. A requisição personalizada pode ser qualquer requisição HTTP, incluindo as comuns GET, POST, PUT, DELETE etc.Adicionar a partir de cURL#
Em processos de trabalho reais, muitas requisições de endpoint são apresentadas na forma de linhas de comando cURL. Você tem a opção de importar requisições cURL para as etapas de teste com apenas um clique.Referenciar outros cenários de teste#
Incluir etapas de outros cenários de teste#
Você pode clonar as etapas de teste ou as condições de controle de processo importando-as de outros cenários de teste dentro do mesmo projeto.Referenciar outros cenários de teste#
Você pode referenciar outros cenários de teste como uma etapa de teste. Há dois casos de uso:1.
Se o seu processo de negócio tiver algumas etapas comuns e reutilizáveis de teste de API, você poderá compilar essas etapas em um pequeno cenário de teste e, em seguida, referenciá-lo diretamente em outros cenários de teste mais amplos.
2.
Se você precisar regredir o processo principal de todo o produto, poderá consultar os vários subcenários de teste no cenário de teste para montagem e concluir o trabalho de regressão de teste de todos os processos principais com um clique.
Para evitar loops infinitos e situações em que o cenário de teste não consiga parar de executar normalmente, o recurso de referenciar outros cenários de teste não pode referenciar o próprio cenário de teste original.
Orquestrando o cenário de teste#
Clicar em qualquer etapa de teste entrará no modo de orquestração. Nesse modo, você tem uma página operacional maior para preencher melhor e com mais eficiência o conteúdo detalhado de cada etapa de teste. O lado esquerdo da página é o fluxo geral do cenário de teste, e o lado direito apresenta os detalhes da etapa de teste selecionada. Requisições de endpoint e componentes de controle do processo de teste terão painéis de exibição diferentes.Você pode ajustar a ordem das etapas arrastando o ≡ na frente da etapa.Você pode usar as teclas "⬆️" e "⬇️" para alternar rapidamente entre as etapas de teste selecionadas nesse modo.No modo de orquestração, você pode editar várias etapas e, em seguida, clicar no botão "Save All" no canto superior esquerdo para salvar todas as alterações.Se alguma etapa tiver alterações não salvas, ela será marcada com um ponto na barra de lista à esquerda. Lembre-se de sempre salvar as alterações que você fez. 
