O Apidog distingue entre endpoints e casos de depuração. Cada endpoint pode ter vários casos de depuração associados. Quando você atualiza o 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 pedidos separados e autónomos. Isto significa que, se fizer uma alteração a um URL ou parâmetro, terá de atualizar manualmente, um a um, todos os pedidos afetados.
Quando envia um pedido ou faz depuração no separador Run de um endpoint, se quiser guardar o pedido permanentemente, pode clicar em Save as case. Esta ação preservará o pedido como um caso de depuração dentro da estrutura do endpoint.
Pode atribuir um nome ao caso de depuração e escolher se pretende guardar a resposta simultaneamente.
Como mencionado anteriormente, a especificação do endpoint é guardada no 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 do pedido: 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-pedido.
Detalhes da resposta recebida.
Definições de validação da resposta: Indicando se a validação está ativada e especificando face a que resposta validar.
Por conseguinte, se modificar a especificação de um parâmetro na especificação do endpoint, o caso de depuração será atualizado em tempo real.
Referenciar Casos de Depuração em Testes Automatizados#
Os casos de depuração podem ser referenciados como passos de teste em cenários de teste automatizados. Quando referenciados, os parâmetros do pedido no caso de depuração serão aplicados diretamente ao passo de teste. Pode ver uma notificação clara de que quaisquer alterações feitas ao caso de depuração atualizarão automaticamente todos os passos de teste que o referenciam.Clique no ícone de referência no canto superior direito para ver que cenários de teste referenciam o caso de depuração e o número total de cenários de teste que o utilizam. Isto dá-lhe uma visão geral de como é utilizado em testes automatizados.
Clicar num cenário de teste leva-o para a página de detalhes do cenário, onde os passos relacionados que utilizam o caso são destacados para facilitar a visualização.
Clicar num passo de teste que referencia o caso de depuração irá notificá-lo de que quaisquer alterações serão sincronizadas com o caso original.
Crie vários casos de depuração para cada endpoint, de modo a abranger diferentes condições.
3.
Para cada caso de depuração, escreva asserções ou outros processadores pré- e pós-pedido.
4.
Referencie casos de depuração em testes automatizados para compor cenários de teste.
5.
Se houver atualizações às especificações da API, tanto os casos de depuração como os cenários de teste podem ser sincronizados. Pode optar por atualizar os cenários de teste manualmente ou configurá-los para serem atualizados automaticamente.
