Variables

Ce que sont les variables

Les variables sont des paires nom/valeur réutilisables que vous définissez une fois et référencez dans vos checks d'API. Au lieu de coder en dur la même URL de base, le même jeton ou le même identifiant de compte dans chaque check, vous enregistrez la valeur comme variable et la référencez par son nom — modifiez-la à un seul endroit et tous les checks qui l'utilisent prennent la nouvelle valeur.

Vous pouvez intégrer des variables dans de nombreuses parties d'un check d'API :

  • URLs — construire dynamiquement les URLs de requête.
  • Corps — insérer des variables directement dans le corps des requêtes POST ou PUT.
  • En-têtes — utiliser des variables dans les valeurs d'en-tête pour plus de flexibilité.
  • Paramètres de requête — enrichir les requêtes GET avec des paramètres de requête dynamiques.
  • Authentification basique — transmettre un nom d'utilisateur et un mot de passe sans les coder en dur dans chaque check.

Gérer les variables

Ouvrez la page Variables pour créer, modifier et supprimer des variables. Les variables sont rattachées à votre équipe, de sorte que tous les membres peuvent les référencer depuis leurs checks.

Créer une variable

  1. Cliquez sur Nouvelle variable.
  2. Saisissez un nom de variable — c'est le nom que vous référencerez dans vos checks (par exemple BASE_URL ou API_TOKEN).
  3. Saisissez une valeur de variable.
  4. Cliquez sur Enregistrer la variable.

Le nom et la valeur sont tous deux obligatoires — une variable avec un nom ou une valeur vide ne peut pas être enregistrée.

Modifier ou supprimer une variable

Utilisez les actions de ligne sur la page Variables pour mettre à jour la valeur d'une variable ou la supprimer. Une modification de valeur prend effet à la prochaine exécution de tout check qui la référence.

Référencer une variable dans un check

Référencez une variable en entourant son nom de doubles accolades : {{NOM_VARIABLE}}. LoadFocus substitue la valeur actuelle de la variable lors de l'exécution du check.

Quelques exemples :

  • URL : https://{{BASE_URL}}/v1/users/{{USER_ID}}
  • En-tête : Authorization: Bearer {{API_TOKEN}}
  • Paramètre de requête : ?account={{ACCOUNT_ID}}
  • Corps : { "email": "{{TEST_EMAIL}}" }

Variables vs. secrets

Utilisez les variables pour des valeurs réutilisables non sensibles comme les URLs de base, les identifiants de compte ou les feature flags — leurs valeurs sont affichées dans la liste des variables.

Utilisez les secrets pour des valeurs sensibles comme les jetons d'API, les mots de passe et les clés de signature. Les secrets sont en écriture seule dans l'interface : une fois enregistrées, leurs valeurs sont masquées et ne sont jamais réaffichées. Référencez un secret comme une variable, avec {{NOM_SECRET}}.

Astuce : si une valeur est sensible, enregistrez-la comme secret plutôt que comme variable afin qu'elle ne soit pas visible dans la liste.

Guides associés

Précédent
Moniteurs de port TCP
Suivant
Rapports externes