Envie e receba requisições HTTP diretamente no XMLSpy
O protocolo HTTP define como os ficheiros (texto, imagens, etc.) são transmitidos através da Internet. Cada servidor web executa um processo que monitoriza continuamente as solicitações HTTP e processa cada uma à medida que são recebidas.
O protocolo HTTP é "stateless", o que significa que cada comando HTTP é executado de forma independente, sem qualquer referência a comandos anteriores ou subsequentes – e isso pode tornar o processo de testes e depuração um desafio.
Para ajudar os programadores, a janela de testes HTTP no XMLSpy orienta-o durante o processo de criação e envio de uma requisição HTTP para um servidor web ou API. Em seguida, pode receber, verificar e solucionar problemas da resposta.
Um pedido é definido no painel esquerdo da janela e pode consistir em:
Depois de definir a solicitação, pressione "Enviar" para enviá-la para o servidor web. Pode analisar a resposta imediatamente no painel do lado direito, que exibe o conteúdo e as informações do cabeçalho.
Nove separadores distintos na janela HTTP permitem armazenar e testar várias mensagens, e alternar entre elas conforme necessário.
O XMLSpy também permite guardar as suas requisições HTTP diretamente no testador HTTP. Isto é útil para reutilizar a mesma configuração ou para fins de documentação. Também pode guardar a resposta HTTP num ficheiro ou copiá-la para um novo documento para trabalhar com ela posteriormente, por exemplo, para gerar automaticamente um esquema JSON ou XML com base na estrutura da resposta.
A janela de testes HTTP suporta requisições POST e PUT do tipo multipart/form-data, que é a forma padrão como as APIs web aceitam o envio de ficheiros e requisições que combinam vários tipos de dados, como campos de texto, JSON e ficheiros binários, numa única mensagem.
As ferramentas de auxílio na criação de requisições complexas simplificam o processo. Para cada parte da requisição, é necessário especificar um nome, indicar se se trata de um valor de texto ou de um ficheiro, definir o tipo de conteúdo e, em seguida, inserir o texto ou selecionar o ficheiro a ser enviado. É possível adicionar tantas partes quantas a API exigir, pelo que enviar vários ficheiros de uma só vez, ou enviar um ficheiro juntamente com os seus metadados JSON, é apenas uma questão de preencher alguns campos.
A janela HTTP pode.. Criar e testar requisições a partir de um documento OpenAPI que descreve uma API. Basta indicar a localização do documento OpenAPI, e a janela HTTP exibirá os caminhos disponíveis, juntamente com as operações correspondentes. Com base na operação e nos parâmetros que selecionar, o XMLSpy gera automaticamente a mensagem de teste, que pode enviar à API, e, em seguida, visualizar os resultados.
Também pode começar a partir do próprio ficheiro OpenAPI: clique com o botão direito em qualquer operação enquanto estiver a editar, e o XMLSpy abrirá uma requisição pronta a ser enviada na janela de testes HTTP, com o caminho, o método, os parâmetros e o corpo da requisição já preenchidos.
Quando uma operação espera um corpo no formato multipart/form-data, o XMLSpy lê o esquema e preenche automaticamente as partes esperadas, incluindo os seus nomes e tipos, para que o utilizador apenas precise adicionar os valores e os caminhos dos ficheiros e enviar.
A janela de testes HTTP também é útil para testar pedidos enviados a qualquer API de inteligência artificial importante, bem como para analisar os resultados da IA no contexto da otimização de prompts.
Depois de inserir a URL do ponto de acesso da API de inteligência artificial, pode selecionar o tipo de conteúdo, inserir a sua chave de API num cabeçalho de autorização e, opcionalmente, adicionar um cabeçalho de organização. Em seguida, insira o corpo da mensagem e envie-o para o ponto de acesso da API.
Com base na resposta obtida, poderá ser necessário ajustar a instrução para obter resultados melhores. Por exemplo, poderá ser necessário modificar a linguagem utilizada no campo da instrução no formato JSON ou experimentar com diferentes parâmetros para refinar o resultado.
Depois de fazer as alterações, pode reenviar o pedido e analisar a nova resposta. Pode repetir este processo para melhorar iterativamente a qualidade e a relevância do resultado gerado pela inteligência artificial.
Utilizar o Testador HTTP para configurar e enviar pedidos HTTP para uma API de inteligência artificial facilita a realização de testes abrangentes e o aperfeiçoamento de instruções em linguagem natural. Com a capacidade de criar e ajustar com precisão os dados enviados nos pedidos, experimentar com vários parâmetros e visualizar instantaneamente respostas detalhadas, os desenvolvedores podem aperfeiçoar facilmente a criação de instruções ao desenvolver soluções baseadas em IA.
Também pode iniciar um teste importando um pedido a partir de um ficheiro WADL (Web Application Description Language), que fornece uma descrição legível por máquina de uma aplicação baseada em HTTP, ou a partir de um documento WSDL que descreve os pontos finais de um serviço web SOAP.
A janela HTTP do XMLSpy inclui um assistente de importação de WADL/WSDL que o guia no processo de abrir um ficheiro, selecionar uma requisição para teste e modificar quaisquer parâmetros editáveis dessa requisição.
Em seguida, importa o pedido para a janela HTTP, permitindo que o envie e visualize a resposta.




