A partir da versão 2.7.29 do Apidog, pode agora adicionar casos de teste diretamente na página de detalhes do endpoint.
Cada caso de teste representa um conjunto de parâmetros de pedido para o endpoint. Os utilizadores podem organizar e gerir 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 pedido, com foco na abrangência.
Abrange uma ampla variedade de cenários: positivos, negativos, de limite e de segurança.
Normalmente 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 resolução de problemas, com foco na rapidez.
Geralmente limitam-se a cenários básicos, como sucesso e falha.
Ao adicionar um caso de teste, pode escolher Import from Debug Cases para copiar ou mover os casos de depuração existentes para casos de teste.
Copiar: Utilize esta opção quando ainda precisar do caso de depuração para validação rápida, mas também o quiser como caso de teste.
Mover: Utilize esta opção quando o caso de depuração já não for frequentemente utilizado para depuração e tiver sido escrito principalmente para testar exceções. Isto converte-o diretamente num 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 do Pedido: Parâmetros de Path, Query, Header e Body form-data.
Corpo do Pedido: Suporta RAW, JSON, XML, etc.
Pré/Pós-processadores
Validação da Resposta: Ative/desative a validação e especifique os componentes da resposta a validar.
[!NOTE] Uma vez que os casos de teste são atualizados com menor frequência, têm de ser sincronizados manualmente com as alterações do endpoint. Por exemplo, se for adicionado um novo campo ao endpoint, terá de clicar em Update no caso de teste para o atualizar.
Quaisquer edições aos detalhes do caso de teste têm de ser guardadas clicando em Save. Se existirem alterações não guardadas, o sistema irá avisá-lo.
No separador Test Cases, pode gerir todos os casos de teste criados. Utilize as funcionalidades de pesquisa e filtro no canto superior esquerdo para encontrar facilmente os casos de teste de que precisa. Também pode utilizar o separador de grupo para visualizar rapidamente os casos de teste por grupo. Para operações em casos de teste específicos:
Caso de Teste Único: Pode abrir um novo separador para ver, 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 eliminar o caso de teste.
Vários Casos de Teste: Quando seleciona vários casos de teste na lista, os botões de ação aparecem no canto superior direito, permitindo agrupar em lote, eliminar e sincronizar com as atualizações do endpoint.
Ao visualizar um caso de teste, clique no botão Run para enviar um pedido com os respetivos parâmetros. A resposta real será então apresentada.
Também pode utilizar Run All ou selecionar vários casos de teste na lista e executá-los em conjunto. A interface irá mostrar quais os casos que estão atualmente em execução e quais têm resultados.
Após uma execução em lote, pode abrir um caso de teste para ver diretamente os respetivos resultados de execução.
Os testes de endpoint único envolvem normalmente duas funções: programadores de backend e engenheiros de QA.
Programadores de Backend: Escrevem e depuram o código do endpoint.
Engenheiros de QA: Realizam testes abrangentes de API e identificam problemas.
Com o Apidog a suportar agora casos de teste para endpoints, o fluxo de trabalho pode ser mais eficiente:
Os engenheiros de QA podem escrever e gerir diretamente casos de teste unitários dentro da documentação do endpoint.
Os programadores podem utilizar casos de teste existentes para executar testes, ver resultados e corrigir problemas por si próprios — sem esperar pelo feedback dos engenheiros de QA ou por comunicações demoradas.
Fluxo de Trabalho Recomendado:
Este fluxo de trabalho pode melhorar a eficiência da colaboração:
1.
Os casos de teste podem ser escritos logo após a documentação do endpoint ser finalizada, ficando visíveis para todos os membros da equipa no Apidog.
2.
Os programadores podem testar os endpoints por si próprios após a depuração — sem necessidade de esperar pelos engenheiros de QA.
3.
Os programadores podem corrigir problemas diretamente com base nos resultados dos testes — sem necessidade de tickets adicionais ou transferências de responsabilidade.
4.
Resultados de teste claros tornam as explicações dos problemas simples, evitando falhas de comunicação.
