Clique em Send na aba Run do endpoint para enviar uma requisição.A interface Run em Endpoint e a interface Request são muito semelhantes. A principal diferença é que Run é baseada no endpoint; ela pode gerar requisições e validar respostas com base na especificação do endpoint. Quando a especificação do endpoint muda, a interface Run também será atualizada de acordo. Por outro lado, Requests são independentes e não estão relacionadas à especificação da API.
Quando você envia uma requisição, o Apidog exibe a resposta recebida do servidor da API de uma forma que permite examiná-la, visualizá-la e solucionar problemas.
Esta interface é dividida em duas seções: a metade superior é onde você insere a requisição que deseja enviar, e a metade inferior exibe a requisição que você realmente envia, a resposta que recebe, bem como os resultados de validação e assertivas da resposta.
TIP
Você pode passar o cursor sobre o botão partition no canto inferior direito para ajustar o layout da interface Run. Você pode optar por dividir a interface horizontalmente, verticalmente ou não dividi-la.
Na seção da metade superior, você pode utilizar variáveis, valores dinâmicos, scripts etc. para ajustar a requisição que envia. Como visualizar a requisição real que está sendo enviada? Você pode ver a requisição real completa na aba Actual Request na metade inferior.
O Apidog valida automaticamente se a resposta está em conformidade com o schema com base na especificação do endpoint. Você pode optar por habilitar ou desabilitar a validação, bem como selecionar em relação a qual resposta validar.
O Apidog oferece suporte à extração de respostas para a especificação do endpoint, que podem ser extraídas como schema de resposta ou exemplos de resposta.
Você pode modificar requisições na aba Run. Você pode alterar valores de parâmetros ou alternar as caixas de seleção à frente dos parâmetros para alterar a requisição. Essas ações não entram em conflito com a especificação do endpoint.Às vezes, pode ser necessário modificar os tipos de parâmetros ou adicionar/remover parâmetros. Nesse caso, a requisição se desvia da especificação do endpoint. No Apidog, essas inconsistências são destacadas em laranja.
Passar o cursor sobre esses marcadores laranja exibirá as diferenças entre a especificação e a requisição atual. Você pode clicar em Revert para restaurá-la ao estado que corresponde à especificação, ou clicar em Save to endpoint spec para atualizar a especificação. Você também pode clicar no botão Inconsistent no canto superior direito para reverter em lote ou salvar todas as diferenças na especificação do endpoint.
Na aba Run, não há botão Save. Isso ocorre porque, para uma especificação de endpoint, ela não inclui o conteúdo das requisições.Para conveniência na depuração, o Apidog fornece um botão Stash. Clicar em Stash salvará o conteúdo atual na interface Run sem afetar a especificação do endpoint, e o conteúdo não será sincronizado com outras pessoas.
Se você deseja salvar uma requisição de forma persistente, pode clicar em Save as case. Essa requisição será salva na forma de um caso de endpoint sob a hierarquia do endpoint.
Você pode salvar cada cenário de uso deste endpoint como um caso de endpoint, facilitando a depuração dos desenvolvedores e fornecendo uma maneira simples de importá-lo para testes automatizados como uma etapa.
Ao importar uma Postman Collection, cada requisição do Postman corresponde a um caso de endpoint no Apidog. Portanto, elas serão exibidas como um caso success sob a hierarquia do endpoint, em vez de dentro da especificação do endpoint. Saiba mais sobre migrar do Postman.
P: Por que a mesma requisição funciona corretamente em outras ferramentas (como Postman), mas não no Apidog?R: Se as requisições forem idênticas, as respostas também devem ser idênticas, independentemente da ferramenta usada. Se você está obtendo respostas diferentes, pode alternar para a aba Actual Request e comparar a requisição que enviou em outras ferramentas para identificar quaisquer diferenças.
