O Apidog distingue entre endpoints e casos de depuração. Cada endpoint pode ter vários casos de depuração vinculados a ele. Quando você atualiza a URL ou os parâmetros do endpoint, todos os casos de depuração relacionados são atualizados automaticamente — sem necessidade de esforço adicional.Em comparação, o Postman trata tudo como requisições separadas e independentes. Isso significa que, se você fizer uma alteração em uma URL ou parâmetro, precisará atualizar manualmente cada requisição afetada, uma por uma.
Quando você envia uma requisição ou realiza uma depuração na guia Run de um endpoint, se quiser salvar a requisição permanentemente, poderá clicar em Save as case. Essa ação preservará a requisição como um caso de depuração dentro da estrutura do endpoint.
Você pode nomear o caso de depuração e escolher se deseja salvar a resposta simultaneamente.
Como mencionado anteriormente, a especificação do endpoint é salva dentro do endpoint, enquanto os valores são armazenados no caso de depuração. Especificamente, um caso de depuração inclui os seguintes dados:
Valores dos parâmetros da requisição: abrangendo parâmetros de caminho, parâmetros de consulta, parâmetros de cabeçalho e parâmetros de corpo no formato form-data.
Conteúdo do corpo: em formatos como RAW, JSON, XML etc.
Processadores pré e pós-requisição.
Detalhes da resposta recebida.
Configurações de validação da resposta: indicando se a validação está habilitada e especificando contra qual resposta validar.
Portanto, se você modificar a especificação de um parâmetro na especificação do endpoint, o caso de depuração será atualizado em tempo real.
Referenciando Casos de Depuração em Testes Automatizados#
Casos de depuração podem ser referenciados como etapas de teste em cenários de teste automatizados. Quando referenciados, os parâmetros da requisição no caso de depuração serão aplicados diretamente à etapa de teste. Você pode ver uma notificação clara informando que quaisquer alterações feitas no caso de depuração atualizarão automaticamente todas as etapas de teste que o referenciam.Clique no ícone de referência no canto superior direito para visualizar quais cenários de teste referenciam o caso de depuração e o número total de cenários de teste que o utilizam. Isso oferece uma visão geral de como ele é usado em testes automatizados.
Clicar em um cenário de teste leva você para a página de detalhes do cenário, onde as etapas relacionadas que usam o caso são destacadas para facilitar a visualização.
Clicar em uma etapa de teste que referencia o caso de depuração notificará você de que quaisquer alterações serão sincronizadas com o caso original.
Defina as especificações da API de forma completa.
2.
Crie vários casos de depuração para cada endpoint para abranger diferentes condições.
3.
Para cada caso de depuração, escreva assertivas ou outros processadores pré e pós-requisição.
4.
Referencie casos de depuração em testes automatizados para compor cenários de teste.
5.
Se houver atualizações nas especificações da API, tanto os casos de depuração quanto os cenários de teste poderão ser sincronizados. Você pode optar por atualizar os cenários de teste manualmente ou configurá-los para atualização automática.