A partir da versão 2.7.29 do Apidog, agora você pode adicionar casos de teste diretamente na página de detalhes do endpoint.
Cada caso de teste representa um conjunto de parâmetros de requisição para o endpoint. Os usuários podem organizar e gerenciar todos os casos de teste de forma sistemática e, em seguida, executá-los com um clique para concluir os testes do endpoint atual.
Casos de teste vs. casos de depuração
Casos de teste
Objetivo: Verificar se o endpoint se comporta conforme esperado em diferentes cenários de requisição, com foco na abrangência.
Abrange uma ampla variedade de cenários: positivos, negativos, de limite e de segurança.
Geralmente são modificados ou executados com menor frequência.
Casos de depuração
Objetivo: Verificar rapidamente as respostas do endpoint durante o desenvolvimento ou a solução de problemas, com foco na velocidade.
Geralmente limitados a cenários básicos, como sucesso e falha.
Ao adicionar um caso de teste, você pode escolher Importar de casos de depuração para copiar ou mover os casos de depuração existentes para casos de teste.
Copiar: Use esta opção quando você ainda precisar do caso de depuração para validação rápida, mas também quiser usá-lo como um caso de teste.
Mover: Use esta opção quando o caso de depuração não for mais usado com frequência para depuração e tiver sido escrito principalmente para testar exceções. Isso o converte diretamente em um caso de teste, tornando a migração mais rápida se os casos de teste tiverem sido originalmente criados como casos de depuração.
Grupo: Organizado por objetivo de teste (positivo, negativo, limite etc.).
Nome do caso: O nome do caso de teste.
Parâmetros da requisição: Parâmetros de Path, Query, Header e corpo form-data.
Corpo da requisição: Compatível com RAW, JSON, XML etc.
Pré/Pós-processadores
Validação da resposta: Ative/desative a validação e especifique os componentes da resposta a serem validados.
[!NOTE] Como os casos de teste são atualizados com menor frequência, eles devem ser sincronizados manualmente com as alterações do endpoint. Por exemplo, se um novo campo for adicionado ao endpoint, você precisará clicar em Atualizar no caso de teste para atualizá-lo.
Qualquer edição nos detalhes do caso de teste deve ser salva clicando em Salvar. Se houver alterações não salvas, o sistema solicitará uma confirmação.
Na guia Casos de teste, você pode gerenciar todos os casos de teste criados. Use os recursos de pesquisa e filtro no canto superior esquerdo para encontrar facilmente os casos de teste de que você precisa. Você também pode usar a guia de grupos para visualizar rapidamente os casos de teste por grupo. Para operações em casos de teste específicos:
Caso de teste único: Você pode abrir uma nova guia para visualizar, modificar e executar um caso de teste. As operações básicas incluem copiar, mover o caso de teste para outros grupos, copiar o cURL do caso de teste e excluir o caso de teste.
Vários casos de teste: Ao selecionar vários casos de teste na lista, botões de ação aparecerão no canto superior direito, permitindo agrupar em lote, excluir e sincronizar com atualizações do endpoint.
Ao visualizar um caso de teste, clique no botão Executar para enviar uma requisição com seus parâmetros. A resposta real será exibida em seguida.
Você também pode usar Executar todos ou selecionar vários casos de teste na lista e executá-los juntos. A interface mostrará quais casos estão em execução no momento e quais têm resultados.
Após uma execução em lote, você pode abrir um caso de teste para visualizar diretamente seus resultados de execução.
O teste de endpoint único geralmente envolve duas funções: desenvolvedores de backend e engenheiros de QA.
Desenvolvedores de backend: Escrevem e depuram o código do endpoint.
Engenheiros de QA: Realizam testes abrangentes de API e identificam problemas.
Como o Apidog agora oferece suporte a casos de teste para endpoints, o fluxo de trabalho pode ser mais eficiente:
Engenheiros de QA podem escrever e gerenciar diretamente casos de teste unitários na documentação do endpoint.
Desenvolvedores podem usar casos de teste existentes para executar testes, visualizar resultados e corrigir problemas por conta própria — sem aguardar o feedback de engenheiros de QA ou passar por longas comunicações.
Fluxo de trabalho recomendado:
Esse fluxo de trabalho pode melhorar a eficiência colaborativa:
1.
Casos de teste podem ser escritos logo após a finalização das documentações de endpoint, ficando visíveis para todos os membros da equipe no Apidog.
2.
Desenvolvedores podem testar endpoints por conta própria após a depuração — sem necessidade de aguardar engenheiros de QA.
3.
Desenvolvedores podem corrigir problemas diretamente com base nos resultados dos testes — sem necessidade de tickets adicionais ou repasses.
4.
Resultados de teste claros tornam as explicações de problemas mais diretas, evitando falhas de comunicação.
