Uma forma simples de testar requisições HTTP durante o desenvolvimento

Os desenvolvedores de aplicações web e serviços web frequentemente precisam enviar requisições HTTP, seja para testar APIs, testar serviços web REST e SOAP, ou para gerir sites.

O XMLSpy facilita o envio e o recebimento de requisições HTTP diretamente no editor de XML e JSON durante o desenvolvimento, através da sua janela HTTP e do assistente de importação de WADL/WSDL, uma ferramenta muito útil para poupar tempo na depuração de serviços web.

Testar requisições HTTP

O protocolo HTTP define como os ficheiros (texto, imagens, etc.) são transmitidos através da Internet. Cada servidor web executa um programa (conhecido como "daemon") que espera continuamente por pedidos HTTP e processa cada um à medida que chegam.

Por exemplo, quando visita a página principal de um site, o seu navegador envia um comando HTTP ao servidor web do site, solicitando o download da página principal; o "daemon" HTTP do servidor recebe a solicitação e envia a página solicitada. É importante notar que o protocolo HTTP é "stateless" (sem estado), 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 teste e a 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. Em seguida, pode receber, verificar e solucionar problemas da resposta.

Um pedido é definido no painel esquerdo da janela e pode consistir em:

O método HTTP da requisição (GET, PUT, POST, etc.) e a URL de destino
Cabeçalhos HTTP da requisição
Configurações de conexão, por exemplo, tempos limite e opções de segurança
Para os métodos POST e PUT, o corpo da mensagem HTTP..

Nove separadores distintos na janela HTTP permitem armazenar e testar várias mensagens, e alternar entre elas conforme necessário.

Quando a requisição estiver definida, pressione "Enviar" para a enviar ao servidor web. Pode analisar a resposta imediatamente no painel do lado direito, que exibe o conteúdo (mostrado acima) e as informações do cabeçalho:

Importar um pedido WADL ou WSDL

Também pode iniciar um teste importando um pedido a partir de um ficheiro WADL (Linguagem de Descrição de Aplicações Web), 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.

Depurar uma API REST

Vamos analisar um exemplo prático, utilizando a janela HTTP para testar a resposta de uma API web. O Portal de Dados da Cidade de Chicago é uma API REST de acesso público que fornece dados interessantes sobre diversos temas, desde licenças de construção até orçamentos municipais, passando pelo número de hospitalizações por asma na cidade.

Para este exemplo, vamos analisar a categoria de tráfego e concentrar-nos num conjunto de dados de infrações de sinal vermelho. Posso inserir a URL na janela HTTP para obter o conjunto de dados completo, e adicionar ".xml" ou ".json" no final da requisição especifica o formato dos dados a serem devolvidos. Neste caso, escolhi XML, mas, naturalmente, o XMLSpy possui ferramentas integradas para trabalhar com ambos os formatos. Pode ver o resultado devolvido pela janela HTTP abaixo.

Podemos analisar os dados no painel de resultados ou clicar em "Criar Novo Documento" para abrir o documento no XMLSpy, seja na visualização de texto ou em formato de tabela, onde é mais fácil navegar e verificar os dados retornados pela API.

Com os dados num ficheiro, podemos até usar o XQuery para analisar ainda mais detalhadamente. Vamos analisar a localização das câmaras com mais de 20 infrações.

Agora, vamos obter os dados novamente, mas desta vez no formato JSON.

Aqui, é aberto na visualização de texto..

E também pode visualizar o JSON na visualização de grade JSON exclusiva do XMLSpy, para uma representação gráfica. A visualização de grade JSON facilita muito a análise e compreensão dos dados retornados, especialmente quando se trata de grandes conjuntos de dados como este. O editor JSON também inclui suporte integrado para filtrar dados com XQuery, como demonstrado abaixo. Filtrei os dados para mostrar apenas os registos que incluem interseções com a rua Halsted.

A janela HTTP, juntamente com as ferramentas de visualização e edição integradas, tornam o XMLSpy uma ferramenta excelente para testar e depurar APIs, serviços web e outras aplicações HTTP.

Descarregue uma versão de avaliação gratuita do XMLSpy para experimentar a janela HTTP.