Um cenário de teste nos testes do Apidog serve como a unidade fundamental, análoga a uma Collection no Postman. Quando precisar de enviar vários pedidos consecutivamente, criar cenários de teste contínuos ou repetir pedidos com diferentes dados de teste, pode criar um cenário de teste e adicionar-lhe os pedidos necessários.Vantagens dos Cenários de Teste#
Ao utilizar cenários de teste no Apidog, pode satisfazer eficientemente uma variedade de requisitos de teste de API:| Funcionalidade | Descrição |
|---|
| Execução Sequencial de Pedidos | Organize e execute vários pedidos numa ordem especificada para simular interações de utilizadores ou fluxos de processos |
| Relatórios de Teste | Gere automaticamente relatórios que fornecem visualizações detalhadas das asserções e dos resultados de pedidos individuais |
| Integração CI/CD | Integre cenários de teste em pipelines CI/CD para garantir testes automáticos durante os ciclos de desenvolvimento, facilitando a deteção precoce de problemas |
| Testes de Desempenho | Avalie o desempenho da API sob cargas variáveis e gere análises de tendências para identificar alterações nos comportamentos de resposta ao longo do tempo |
| Teste de Parâmetros Dinâmicos | Execute pedidos várias vezes utilizando parâmetros gerados dinamicamente para testar como a API lida com entradas variáveis |
| Dados de Teste Predefinidos | Utilize dados predefinidos para pedidos, de modo a simular condições de operação realistas e verificar as respostas da API em relação aos resultados esperados |
| Passagem de Dados Entre Pedidos | Passe automaticamente dados da saída de um pedido para outro, algo crucial para testar APIs que exigem persistência de estado entre chamadas |
| Relações Lógicas entre Pedidos | Configure condições lógicas, como if, for e foreach, para gerir o fluxo de execução com base nos resultados de pedidos anteriores ou em condições específicas |
Estas funcionalidades permitem-lhe criar ambientes de teste versáteis e eficazes que contribuem para um desenvolvimento de APIs robusto e de elevada qualidade.Criar um Cenário de Teste#
Ao abrir o Apidog, navegue para o módulo "Testes" e, em seguida, clique no + junto à barra de pesquisa para criar um novo cenário de teste. Selecione o diretório adequado para o mesmo e defina a prioridade para concluir a criação.Adicionar Passos de Teste#
Depois de configurar o seu cenário de teste no Apidog, pode começar a preenchê-lo com pedidos. Existem várias formas de adicionar pedidos, cada uma adaptada a diferentes necessidades e níveis de flexibilidade:Pedidos Ligados à Especificação do Endpoint#
Estes pedidos podem ser atualizados à medida que a especificação do endpoint muda:Importar da Especificação do Endpoint#
No modo "Manual", as modificações na documentação do endpoint dentro do projeto não têm um impacto imediato nos endpoints nos passos de teste. A sincronização dos dados de teste só ocorre quando os responsáveis pelos testes ativam o botão "Manual". É importante observar que as alterações efetuadas aos dados dos passos de teste não atualizam a documentação do endpoint, mesmo ao clicar em "Sincronização Manual". Em vez disso, clicar neste botão permite que os cenários de teste obtenham informações da documentação do endpoint para fins de sincronização.No modo "Automatizado", quaisquer alterações na documentação do endpoint dentro do projeto serão atualizadas de forma síncrona nos passos de teste.Importar de Caso de Endpoint#
Pode optar por importar casos de endpoint do projeto atual ou de outros projetos. Existem dois modos ao importar casos de endpoint: "Copiar" e "Referência".Ao importar um caso de endpoint como "Copiar", os parâmetros no caso de endpoint também serão copiados para os passos de teste. Serão independentes entre si, e as alterações em cada um não afetarão os restantes. Pode selecionar a sincronização manual.Ao importar um caso de endpoint como "Referência", este utilizará diretamente o caso de endpoint do projeto original para o pedido.Se o passo de teste for referenciado a partir de um caso, verá uma mensagem a indicar que modificar este passo também afetará o caso de endpoint original e quaisquer outros passos que o utilizem.Pedidos Independentes Não Associados à Especificação da API#
Estes pedidos não são atualizados em resposta a alterações na especificação da API. Permitem uma maior personalização:Adicionar Pedido Personalizado#
Num processo de trabalho, poderá precisar de chamar um endpoint fora do projeto, como um endpoint de pagamento de terceiros.Pode adicionar um pedido de API personalizado nos passos de teste. O pedido personalizado pode ser qualquer pedido HTTP, incluindo os métodos comuns GET, POST, PUT, DELETE, etc.Adicionar a partir de cURL#
Em processos de trabalho reais, muitos pedidos de endpoint são apresentados sob a forma de linhas de comando cURL. Tem a opção de importar pedidos cURL para os passos de teste com apenas um clique.Referenciar Outros Cenários de Teste#
Incluir Passos de Outros Cenários de Teste#
Pode clonar os passos de teste ou as condições de controlo do processo ao importar de outros cenários de teste dentro do mesmo projeto.Referenciar Outros Cenários de Teste#
Pode referenciar outros cenários de teste como um passo de teste. Existem dois casos de utilização:1.
Se o seu processo de negócio tiver alguns passos de teste de API comuns e reutilizáveis, pode compilar estes passos num pequeno cenário de teste e, em seguida, referenciá-lo diretamente noutros cenários de teste mais abrangentes.
2.
Se precisar de efetuar a regressão do processo principal de todo o produto, pode referenciar 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, a funcionalidade de referenciar outros cenários de teste não pode referenciar o próprio cenário de teste original.
Orquestrar o Cenário de Teste#
Ao clicar em qualquer passo de teste, entrará no modo de orquestração. Neste modo, tem uma página de operação maior para preencher melhor e de forma mais eficiente o conteúdo detalhado de cada passo de teste. O lado esquerdo da página apresenta o fluxo geral do cenário de teste, e o lado direito apresenta os detalhes do passo de teste selecionado. Os pedidos de endpoint e os componentes de controlo do processo de teste terão painéis de apresentação diferentes.Pode ajustar a ordem dos passos arrastando o ≡ à frente do passo.Pode utilizar as teclas "⬆️" e "⬇️" para alternar rapidamente entre os passos de teste selecionados neste modo.No modo de orquestração, pode editar vários passos e, em seguida, clicar no botão "Guardar Tudo" no canto superior esquerdo para guardar todas as alterações.Se algum passo tiver alterações por guardar, o passo será marcado com um ponto na barra de lista à esquerda. Lembre-se de guardar sempre as alterações que efetuou.