Pour vous familiariser avec le concept de variables, nous vous recommandons de lire notre article Variables où vous trouverez des informations sur leur fonctionnement. Cet article vous fournit une vue d’ensemble des variables prédéfinies et vous explique comment les utiliser et les configurer dans un moniteur d’API multi-étapes.
Variables prédéfinies
Les variables prédéfinies vous permettent d’extraire et de stocker des valeurs issues de réponses HTTP, ou de préciser vos propres valeurs au début d’un scénario d’API. La section où ces variables peuvent être spécifiées se trouve sous l' éditeur d’étapes.
Comme indiqué dans l’image, la variable {{BaseUrl}}
correspond à la valeur https://galacticresorts.com. Au lieu de devoir systématiquement définir des URL pour chaque étape, vous pouvez facilement utiliser la variable pour cibler différents endpoints à chaque étape, comme {{BaseUrl}}/Products et {{BaseUrl}}/Status. Vous pouvez aussi passer d’un environnement à un autre en actualisant simplement la valeur de la variable pour indiquer https://test-galacticresorts.com.
Les variables prédéfinies sont aussi fréquemment utilisées pour stocker une clé API pour l’authentification. En définissant vos identifiants sous forme de variable, vous pouvez gérer des informations sensibles en toute sécurité et actualiser la valeur depuis un seul emplacement dès que nécessaire. Vous pouvez aussi récupérer et utiliser des identifiants de coffre-fort comme variables prédéfinies.
Configurer des variables prédéfinies
Voici comment ajouter une variable prédéfinie :
- Sous l' éditeur visuel d’étapes, ouvrez Variables prédéfinies.
- Cliquez sur .
- Précisez le nom de la variable dans le champ Nom. Par exemple,
BaseUrl. - Cliquez sur et sélectionnez une valeur. Cette valeur peut prendre la forme d’un texte brut ou d’un identifiant de coffre-fort.
- Spécifiez la valeur de la variable. Par exemple
https://test.yourapi.com.
Une fois la variable créée, vous pouvez l’utiliser dans vos étapes d’API en utilisant la syntaxe suivante : {{VariableName}}. Pour faire référence à cette variable comme URL de base pour chaque étape d’API, vous pouvez utiliser {{BaseURL}}/UserService/GetUserInfo ou {{BaseURL}}/UserService/GetProductInfo. Cela vous permet d’actualiser facilement la valeur de la variable pour qu’elle pointe vers un environnement différent (par exemple, un environnement de test ou de production), sans devoir modifier chaque étape.
Utiliser des identifiants de coffre-fort comme variables prédéfinies
Les variables prédéfinies peuvent également stocker des informations sensibles et être utilisées à n’importe quel endroit dans le scénario d’API. Si votre API nécessite une authentification, comme une connexion ou l’utilisation d’un jeton d’accès, vous pouvez utiliser une variable pour stocker vos identifiants et l’utiliser dans vos requêtes.
Uprends vous fournit un coffre-fort où vous pouvez stocker vos données personnelles en toute sécurité dans votre compte Uptrends.
Voici comment utiliser des identifiants de coffre-fort sous forme de variable prédéfinie :
- Vérifiez que vous avez ajouté vos informations de connexion dans le coffre-fort d’Uptrends.
- Configurez une variable prédéfinie.
- Cliquez sur .
- Sélectionnez Identifiants de coffre-fort.
- Sélectionnez un jeu d’identifiants ainsi que sa valeur. Par exemple, sélectionnez un jeu incluant un nom d’utilisateur et un mot de passe.
- Cliquez sur Sélectionnez.
Une fois la variable créée, vous pouvez l’utiliser dans les étapes d’API. Dans l’exemple, le jeu d’identifiants a été utilisé dans les en-têtes de réponse. Dans les résultats des détails de vérification du moniteur, les valeurs sont masquées pour que les données sensibles restent confidentielles.
