Una forma sencilla de probar las solicitudes HTTP durante el desarrollo
Los desarrolladores de aplicaciones web y servicios web a menudo necesitan enviar solicitudes HTTP, ya sea para probar APIs, para probar servicios web REST y SOAP, o para administrar sitios web.
XMLSpy facilita el envío y la recepción de solicitudes HTTP directamente en el editor de XML y JSON durante el desarrollo, gracias a su ventana HTTP y al asistente de importación de WADL/WSDL, una herramienta muy útil para ahorrar tiempo en la depuración de servicios web.
Pruebas de solicitudes HTTP
El protocolo HTTP define cómo se transmiten los archivos (texto, imágenes, etc.) a través de Internet. Cada servidor web ejecuta un programa (conocido como demonio) que espera continuamente las solicitudes HTTP y las procesa a medida que llegan.
Por ejemplo, cuando visita la página principal de un sitio web, su navegador envía un comando HTTP al servidor web del sitio que solicita la descarga de la página principal; el demonio HTTP del servidor recibe la solicitud y envía la página solicitada. Es importante destacar que el protocolo HTTP es "stateless" (sin estado), lo que significa que cada comando HTTP se ejecuta de forma independiente, sin ninguna referencia a comandos anteriores o posteriores, y esto puede dificultar las pruebas y la depuración.
Para ayudar a los desarrolladores en esta tarea, la ventana de pruebas HTTP en XMLSpy los guía a través del proceso de creación y envío de una solicitud HTTP a un servidor web. Luego, pueden recibir, verificar y solucionar problemas de la respuesta.
La solicitud se define en el panel izquierdo de la ventana y puede constar de:
- El método HTTP de la solicitud (GET, PUT, POST, etc.) y la URL de destino
- Encabezados HTTP de la solicitud
- Ajustes de conexión, por ejemplo, tiempos de espera y opciones de seguridad
- Para los métodos POST y PUT, el cuerpo del mensaje HTTP
La ventana HTTP cuenta con nueve pestañas diferentes donde se pueden almacenar y probar varios mensajes, y cambiar entre ellos según sea necesario.
Una vez que la solicitud esté definida, presione "Enviar" para enviarla al servidor web. Puede analizar la respuesta inmediatamente en el panel derecho, que muestra el cuerpo (mostrado anteriormente) y la información del encabezado:
Importar una solicitud WADL o WSDL
También puede iniciar una prueba importando una solicitud desde un archivo WADL (Lenguaje de Descripción de Aplicaciones Web), que proporciona una descripción legible por máquinas de una aplicación basada en HTTP, o desde un documento WSDL que describe los puntos finales de un servicio web SOAP.
La ventana HTTP de XMLSpy incluye un asistente de importación WADL/WSDL que le guiará mientras abre el archivo, selecciona una solicitud para probarla y modifica los parámetros editables de la solicitud.
Luego, importa la solicitud a la ventana HTTP para que pueda enviarla y revisar la respuesta.
Depuración de una API REST
Analicemos un ejemplo práctico, utilizando la ventana HTTP para probar la respuesta de una API web. El Portal de Datos de la Ciudad de Chicago es una API REST de acceso público que proporciona información interesante sobre una amplia variedad de temas, desde permisos de construcción hasta presupuestos municipales, e incluso el número de hospitalizaciones por asma en la ciudad.
Para este ejemplo, analizaremos la categoría de tráfico y nos centraremos en un conjunto de datos de infracciones de semáforos. Puedo ingresar la URL en la ventana HTTP para obtener todo el conjunto de datos, y finalizar la solicitud con ".xml" o ".json" especifica el formato de los datos que se devolverán. En esta ocasión, he elegido XML, pero, por supuesto, XMLSpy tiene herramientas integradas para trabajar con ambos formatos. A continuación, puede ver el resultado que se devuelve en la ventana HTTP.
Podemos revisar los datos en el panel de resultados o hacer clic en "Crear nuevo documento" para abrir el documento en XMLSpy, ya sea en la vista de texto o en la vista de cuadrícula, donde es más fácil desplazarse y verificar los datos devueltos por la API.
Con los datos almacenados en un archivo, podemos incluso utilizar XQuery para analizar la información con mayor detalle. Veamos, por ejemplo, las ubicaciones de las cámaras que registran más de 20 infracciones.
Ahora, vamos a recuperar los datos nuevamente, pero esta vez en formato JSON.
Aquí se abre en modo de texto..
También puede visualizar el JSON en la vista de cuadrícula JSON única de XMLSpy, lo que proporciona una representación gráfica. La vista de cuadrícula JSON facilita mucho la revisión y comprensión de los datos devueltos, especialmente cuando se trata de conjuntos de datos grandes como este. El editor de JSON también incluye soporte integrado para filtrar datos con XQuery, como se muestra a continuación. He filtrado los datos para mostrar solo los registros que incluyen intersecciones con la calle Halsted.
La ventana HTTP, junto con las herramientas integradas de visualización y edición, convierten a XMLSpy en una herramienta excelente para probar y depurar APIs, servicios web y otras aplicaciones HTTP.
Descargue una versión de prueba gratuita de XMLSpy para probar la ventana HTTP.