Clique em Send no separador Run do endpoint para enviar um pedido.A interface Run em Endpoint e a interface Request são muito semelhantes. A principal diferença é que Run se baseia no endpoint: pode gerar pedidos e validar respostas com base na especificação do endpoint. Quando a especificação do endpoint muda, a interface Run também será atualizada em conformidade. Por outro lado, os Requests são independentes e não estão relacionados com a especificação da API.
Quando envia um pedido, o Apidog apresenta a resposta recebida do servidor da API de uma forma que lhe permite examiná-la, visualizá-la e resolver problemas.
Esta interface está dividida em duas secções: a metade superior é onde introduz o pedido que pretende enviar, e a metade inferior apresenta o pedido que efetivamente envia, a resposta que recebe, bem como os resultados de validação e asserção da resposta.
TIP
Pode passar o cursor sobre o botão partition no canto inferior direito para ajustar o layout da interface Run. Pode optar por dividir a interface horizontalmente, verticalmente ou não a dividir.
Na secção da metade superior, pode utilizar variáveis, valores dinâmicos, scripts, etc., para ajustar o pedido que envia. Como visualizar o pedido efetivo que está a ser enviado? Pode ver o pedido efetivo completo no separador 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. Pode optar por ativar ou desativar a validação, bem como selecionar contra que resposta pretende validar.
Pode modificar pedidos no separador Run. Pode alterar valores de parâmetros ou ativar/desativar as caixas de seleção à frente dos parâmetros para alterar o pedido. Estas ações não entram em conflito com a especificação do endpoint.Por vezes, poderá precisar de modificar os tipos de parâmetros ou adicionar/remover parâmetros. Neste caso, o pedido diverge da especificação do endpoint. No Apidog, estas inconsistências são realçadas a laranja.
Ao passar o cursor sobre estes marcadores laranja, serão apresentadas as diferenças entre a especificação e o pedido atual. Pode clicar em Revert para restaurar o estado que corresponde à especificação, ou clicar em Save to endpoint spec para atualizar a especificação. Também pode clicar no botão Inconsistent no canto superior direito para reverter em lote ou guardar todas as diferenças na especificação do endpoint.
No separador Run, não existe botão Save. Isto acontece porque, para uma especificação de endpoint, esta não inclui o conteúdo dos pedidos.Para facilitar a depuração, o Apidog disponibiliza um botão Stash. Ao clicar em Stash, o conteúdo atual da interface Run será guardado sem afetar a especificação do endpoint, e o conteúdo não será sincronizado com outras pessoas.
Se pretender guardar um pedido de forma persistente, pode clicar em Save as case. Este pedido será guardado sob a forma de um caso de endpoint na hierarquia do endpoint.
Pode guardar cada cenário de utilização deste endpoint como um caso de endpoint, facilitando a depuração por parte dos programadores e proporcionando uma forma simples de o importar para testes automatizados como um passo.
Ao importar uma Postman Collection, cada pedido Postman corresponde a um caso de endpoint no Apidog. Portanto, serão apresentados como um caso success na hierarquia do endpoint, em vez de dentro da especificação do endpoint. Saiba mais sobre migrar a partir do Postman.
P: Porque é que o mesmo pedido funciona corretamente noutras ferramentas (como o Postman), mas não no Apidog?R: Se os pedidos forem idênticos, então as respostas também deverão ser idênticas, independentemente da ferramenta utilizada. Se estiver a obter respostas diferentes, pode mudar para o separador Actual Request e comparar o pedido que enviou noutras ferramentas para identificar eventuais diferenças.
