Proxyman ya admite el método HTTP QUERY
Las API suelen necesitar buscar o filtrar datos. Para una búsqueda sencilla, normalmente basta con una solicitud GET. Pero cuando la búsqueda tiene muchos filtros, una URL larga se vuelve difícil de leer y de mantener.
Ahora existe un nuevo método HTTP llamado QUERY. Ofrece a una API una forma clara de decir: «Busca estos datos por mí, pero no cambies nada».
Proxyman ahora admite solicitudes QUERY en toda la app. Puedes crear una a mano, verla en el tráfico capturado, filtrarla en una lista con muchas solicitudes y usarla con tus herramientas de depuración habituales.
1. ¿Qué es el método HTTP QUERY?
QUERY es un nuevo método HTTP para pedir a un servidor que busque, filtre o seleccione datos. Los detalles de la consulta se envían en el cuerpo de la solicitud, en lugar de en la URL.
La idea principal es sencilla: una solicitud QUERY sirve para leer datos. No debería crear, actualizar ni eliminar nada, y es seguro volver a enviarla si hace falta.
El método está definido en RFC 10008. Como cualquier método HTTP, solo funciona cuando el servidor de la API ha decidido admitirlo.
¿En qué se diferencia de GET y POST?
GET, QUERY y POST pueden enviar datos de entrada a una API. La diferencia está en dónde van esos datos y en lo que el método indica sobre la solicitud.
- GET coloca los valores de búsqueda en la URL. Funciona bien para solicitudes pequeñas que la gente puede querer guardar en marcadores o compartir:
/products?brand=Proxyman&sort=price. - QUERY coloca los valores de búsqueda en el cuerpo de la solicitud. Se adapta a una búsqueda detallada con muchos filtros e indica al servidor que la solicitud es de solo lectura.
- POST también envía datos en el cuerpo de la solicitud. Suele crear o modificar algo, como enviar un pedido. Una API puede usar
POSTpara una búsqueda, pero el método por sí solo no indica si cambia datos.
En resumen: usa GET para una consulta sencilla basada en la URL, QUERY para una búsqueda detallada de solo lectura y POST cuando la acción pueda crear o modificar datos.
Un ejemplo sencillo con cURL
Imagina una tienda en línea que permite buscar productos con un conjunto detallado de filtros. La siguiente solicitud pide auriculares inalámbricos disponibles, ordenados por precio:
curl --request QUERY 'https://api.example.com/products/search' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"text": "wireless headphones",
"filters": {
"inStock": true
},
"sort": "price"
}'
La parte --request QUERY elige el método HTTP. El JSON que aparece debajo es la entrada de búsqueda, y Content-Type indica al servidor que se trata de JSON.
Con GET, la misma búsqueda tendría que caber en la URL. Eso puede resultar incómodo cuando tiene muchos campos.
No des por hecho que todas las API aceptan QUERY todavía. Si el servidor no lo admite, es posible que veas 405 Method Not Allowed. Esa respuesta viene del servidor de la API, no de Proxyman.
2. Crea una solicitud QUERY en Proxyman
Ahora puedes enviar una solicitud QUERY directamente desde la herramienta Compose. Resulta útil cuando quieres probar un nuevo endpoint, revisar una respuesta o comparar el resultado con una solicitud GET o POST.
- Abre Compose en Proxyman.
- Elige QUERY en el menú de métodos.
- Introduce la URL de la API.
- Añade los encabezados que requiera la API. En una solicitud JSON, normalmente es
Content-Type: application/json. - Introduce los datos de búsqueda en la pestaña Body.
- Haz clic en Send y revisa la respuesta a la derecha.
La captura de pantalla muestra una respuesta 405 Method Not Allowed. Confirma que Proxyman envió QUERY, mientras que el endpoint seleccionado no lo admite. Usa un endpoint que documente la compatibilidad con QUERY si quieres obtener una respuesta exitosa.
3. Encuentra rápidamente el tráfico QUERY
Cuando una app empieza a usar QUERY, puede pasar desapercibido entre muchas solicitudes GET y POST. Proxyman muestra QUERY en la columna Method, así que puedes identificarlo de un vistazo.
Para centrarte en ellas, abre la barra de filtros y establece Method en QUERY. Proxyman mostrará solo las solicitudes que coincidan, listas para que las inspecciones o compares.
Es especialmente útil al probar una pantalla de búsqueda: haz un cambio, vuelve a ejecutar la búsqueda y localiza la solicitud correspondiente sin tener que revisar tráfico no relacionado.
4. Usa QUERY con las herramientas de depuración que ya conoces
QUERY no se limita a Compose y a los filtros. Proxyman lo reconoce en cualquier lugar donde importe el método de la solicitud, así que encaja en el flujo de depuración habitual.
- Detalles de la solicitud: Consulta
QUERYen la solicitud capturada y lee sus encabezados, valores de consulta, cuerpo y respuesta igual que lo harías con cualquier otro método. - Debugging Tools: Cuando una herramienta te permita hacer coincidir una solicitud por método, elige
QUERYpara que una regla se aplique solo a esas búsquedas. Tu tráficoGETyPOSTpuede quedar intacto. - Scripting: Ejecuta un script solo para las solicitudes
QUERY. Resulta útil cuando quieres revisar los datos de búsqueda, añadir un encabezado de prueba o modificar una respuesta durante las pruebas locales. - Breakpoint: Pausa una solicitud
QUERYantes de que llegue al servidor. Puedes revisar o editar los datos de búsqueda, después enviarla y inspeccionar el resultado.
Estos controles permiten que una regla o un script apunte exactamente a las solicitudes que quieres probar, sin afectar a una solicitud de actualización o de pago.
5. Resumen y próximos pasos
El método HTTP QUERY deja más claro el propósito de una API: pide datos, no los cambia. Es útil cuando una búsqueda necesita más detalle del que cabe cómodamente en una URL corta.
Con Proxyman, ahora puedes:
- Crear y enviar solicitudes
QUERYen Compose - Capturar e inspeccionar el tráfico
QUERY - Filtrar la lista principal por el método
QUERY - Aplicar reglas a solicitudes
QUERYen Debugging Tools, Scripting y Breakpoint
La compatibilidad con un nuevo método HTTP lleva tiempo. Antes de usarlo en una app, revisa la documentación de la API o prueba primero el endpoint. Si devuelve 405 Method Not Allowed, todavía no admite QUERY.
Prueba la ruta completa desde la app hasta el servidor, no solo el servidor en sí. Un gateway antiguo, un firewall o una biblioteca cliente desactualizada puede rechazar un método que no conoce. Revisa también el comportamiento de reintentos y de caché en tu propio sistema: el método indica que la solicitud es de solo lectura, pero cada parte de la ruta debe gestionarla correctamente.
Mantén Proxyman actualizado y estarás listo para inspeccionar y depurar el tráfico QUERY a medida que más API lo adopten. Para saber más, lee la RFC 10008 o visita la documentación de Proxyman.
Guías relacionadas
