Paramètres de requête

Utiliser les paramètres de requête

Vous pouvez ajouter des paramètres de requête à votre requête soit dans l'URL, soit dans le champ Paramètres de requête :

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

Les deux méthodes sont valides. Si vous ajoutez des paramètres de requête dans l'URL et également dans les champs Paramètres de requête, ils seront concaténés et tous les paramètres de requête seront utilisés.

Note : Vous ne pouvez pas rendre un paramètre de requête global (par exemple, une clé API) et l'utiliser avec toutes les requêtes. Vous devez ajouter le paramètre de chaîne de requête à chaque requête dans l'URL ou dans les champs Paramètres de requête.

Pourquoi utiliser le champ Paramètres de requête plutôt que l'URL

Les deux approches fonctionnent et finissent concaténées dans la même requête, mais elles conviennent à des situations différentes. Saisir les paramètres directement dans l'URL est plus rapide lorsqu'ils sont statiques et courts, comme un identifiant de page ou un indicateur de locale. Le champ Paramètres de requête, que l'on trouve dans les options avancées d'une requête aux côtés des en-têtes, du corps POST et des cookies, est plus facile à lire et à modifier une fois que vous avez plusieurs paramètres, et il garde l'URL de base propre, ce qui compte si vous comparez des requêtes ou lisez les résultats de test en un coup d'œil.

Pièges courants

• Les caractères spéciaux doivent être encodés. Les espaces, les esperluettes et les autres caractères réservés à l'intérieur d'une valeur doivent être encodés en URL (un espace en %20 ou +, une & en %26), sinon la requête est analysée comme des paramètres supplémentaires non voulus, ou comme une URL malformée.
• Pas de paramètres globaux ou partagés. Comme indiqué ci-dessus, LoadFocus ne permet pas de définir un paramètre de requête une seule fois et de l'appliquer à toutes les requêtes du test. Si chaque requête a besoin de la même clé API ou du même jeton en tant que paramètre de requête, vous devez l'ajouter individuellement à chaque requête, dans l'URL ou dans le champ Paramètres de requête.
• Clés dupliquées aux deux endroits. Si vous placez query1=value1 dans l'URL et ajoutez également une entrée query1 dans le champ Paramètres de requête, les deux sont envoyées, puisque les deux sources sont concaténées plutôt que fusionnées ou dédupliquées. Faites attention à cela lorsque vous copiez une URL qui contient déjà des paramètres puis en ajoutez d'autres via le champ.
• L'ordre n'a pas forcément d'importance garantie, mais vérifiez votre API. La plupart des API traitent les paramètres de requête comme un ensemble non ordonné, mais si la vôtre les analyse de façon positionnelle ou a des particularités avec des clés répétées, testez la forme exacte de requête que vous attendez en production.

Un exemple pratique

Tester un point de terminaison de recherche paginé pourrait ressembler à ceci dans l'URL :

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

Si vous exécutez des variations de la même requête avec différents numéros de page au sein d'un plan de test, déplacer page vers le champ Paramètres de requête rend évident en un coup d'œil quelle valeur change entre les requêtes, sans avoir à scanner toute la chaîne d'URL à chaque fois.