Parámetros de Consulta

Usar Parámetros de Consulta

Puedes agregar parámetros de consulta a tu solicitud ya sea en la URL o en el campo de Parámetros de Consulta:

https://www.example.com?query1=value1&query2=value2
https://www.example.com?query1=value1&query2=value2#hash1
https://api.example.com/v2/resources/1?query1=value1&query2=value2

Ambos métodos son válidos; si añades parámetros de consulta en la URL y también en los campos de Parámetros de Consulta, se concatenarán y se usarán todos los parámetros de consulta.

Nota: No puedes hacer que un Parámetro de Consulta sea global (por ejemplo, una clave de API) y usarlo en todas las solicitudes; necesitas añadir el parámetro de la cadena de consulta a cada solicitud, en la URL o en los campos de Parámetros de Consulta.

Por Qué Usar el Campo de Parámetros de Consulta en Lugar de la URL

Ambos enfoques funcionan y terminan concatenados en la misma solicitud, pero se adaptan a situaciones distintas. Escribir los parámetros directamente en la URL es lo más rápido cuando son estáticos y cortos, como un ID de página o un indicador de idioma. El campo Parámetros de Consulta, que se encuentra en las opciones avanzadas de una solicitud junto con las cabeceras, el cuerpo POST y las cookies, es más fácil de leer y editar cuando tienes varios parámetros, y mantiene limpia la URL base, lo cual importa si estás comparando solicitudes o leyendo resultados de prueba de un vistazo.

Errores Comunes

• Los caracteres especiales necesitan codificación. Los espacios, los ampersands y otros caracteres reservados dentro de un valor deben codificarse en la URL (un espacio como %20 o +, un & como %26), de lo contrario la solicitud se interpreta con parámetros adicionales que no pretendías, o como una URL mal formada.
• No hay parámetros globales o compartidos. Como se indicó antes, LoadFocus no te permite definir un parámetro de consulta una vez y aplicarlo a cada solicitud de la prueba. Si cada solicitud necesita la misma clave de API o token como parámetro de consulta, tienes que añadirlo individualmente a cada solicitud, en la URL o en el campo de Parámetros de Consulta.
• Claves duplicadas en ambos sitios. Si pones query1=value1 en la URL y también añades una entrada query1 en el campo de Parámetros de Consulta, ambas se envían, ya que las dos fuentes se concatenan en lugar de fusionarse o deduplicarse. Ten cuidado con esto al copiar una URL que ya tiene parámetros y luego añadir más a través del campo.
• No se garantiza que el orden importe, pero comprueba tu API. La mayoría de las APIs tratan los parámetros de consulta como un conjunto sin orden, pero si la tuya los interpreta de forma posicional o tiene peculiaridades con claves repetidas, prueba la forma exacta de solicitud que esperas en producción.

Un Ejemplo Práctico

Probar un endpoint de búsqueda paginado podría verse así en la URL:

https://api.example.com/v2/search?q=laptop&page=1&sort=price_asc

Si estás ejecutando variaciones de la misma solicitud con distintos números de página a lo largo de un plan de prueba, mover page al campo de Parámetros de Consulta deja claro de un vistazo qué valor cambia entre solicitudes, sin tener que escanear toda la cadena de URL cada vez.