Environnements et variables

Un environnement regroupe les valeurs réutilisables par vos requêtes. Conservez l'adresse {{baseUrl}}/orders/{{orderId}} et sélectionnez un autre environnement pour changer de serveur ou de compte.

Créer et sélectionner un environnement

Ouvrez les environnements de l'espace, ajoutez-en un et donnez-lui un nom clair, comme Development. Ajoutez une ligne par valeur, par exemple baseUrl, orderId ou accessToken. L'éditeur enregistre les modifications automatiquement.

Sélectionnez l'environnement dans la barre supérieure avant l'envoi. Ce sélecteur global liste les environnements de l'organisation actuelle et applique le choix aux onglets de requêtes ouverts. L'éditeur et la barre latérale continuent à les regrouper par espace. Vérifiez le choix après un changement de workspace ou l'ouverture d'une collection importée.

Référencer une variable

Utilisez des doubles accolades dans les URLs, paramètres de requête, en-têtes, réglages d'authentification et corps textuels :

{{baseUrl}}/orders/{{orderId}}
Authorization: Bearer {{accessToken}}

La saisie automatique suggère les noms, et l'éditeur d'URL distingue les références connues de celles qui ne sont pas résolues. Si un nom ne se résout pas, vérifiez son orthographe, l'environnement et la présence d'une valeur. Une référence non résolue peut rester dans le texte envoyé.

Les scripts lisent et modifient les valeurs avec pm.environment et pm.variables. Pour une collection, pm.iterationData lit les colonnes CSV ou propriétés JSON. Les données de l'itération priment sur une valeur du même nom dans l'environnement. Consultez automatisation et tests.

Enregistrer un secret

Marquez comme secrète une valeur contenant un mot de passe, un jeton ou une clé. Echo protège ces valeurs dans son stockage chiffré et les masque dans l'éditeur. Une requête utilisant un secret l'envoie à la destination choisie : vérifiez l'adresse avant l'envoi.

Les exports vers un dossier lié excluent les valeurs secrètes. Fournissez-les séparément sur une autre machine, sans les enregistrer dans Git. Vérifiez aussi les autres champs et fichiers : marquer une variable ne protège pas automatiquement du contenu collé ailleurs.

Résoudre une référence Azure Key Vault

Choisissez le type de référence Key Vault et indiquez l'URI du secret :

https://your-vault.vault.azure.net/secrets/api-token

Vous pouvez ajouter une version à la fin pour la fixer. Utilisez l'action de test pour vérifier l'accès. L'appareil doit disposer d'une identité Azure autorisée à lire ce secret ; la connexion à Gapfy ne donne pas accès au coffre.

Echo enregistre et synchronise la référence, puis résout sa valeur pour l'exécution. La valeur reste en mémoire pendant la durée configurée, cinq minutes par défaut. Les réglages avancés permettent de modifier cette durée ou d'oublier les identifiants Azure. Corrigez un refus d'accès, un secret absent ou un échec de connexion avant d'exécuter la requête.

Générer des données de test

Les variables dynamiques ne nécessitent aucune ligne dans l'environnement. Utilisez notamment {{$guid}}, {{$randomUUID}}, {{$timestamp}}, {{$isoTimestamp}}, {{$randomInt}}, {{$randomBoolean}} et {{$randomEmail}}. Les suggestions incluent aussi noms, villes, pays, téléphones, URLs, adresses IP, mots, prix et entreprises.

Choisissez-les pour obtenir de nouveaux exemples. Pour des entrées fixes et reproductibles, chargez un CSV ou JSON dans l'exécuteur de collections.

Utiliser les mocks du bureau

L'option de mock de l'environnement fournit une URL de base gérée pour les mocks de l'espace. Utilisez la variable proposée par Echo. Les mocks du bureau répondent dans Echo et n'ouvrent aucun port pour une autre application. Consultez l'hébergement public des mocks pour obtenir une URL HTTP partagée.

Comparer les réponses

Activez le mode de comparaison et choisissez jusqu'à quatre environnements. Un seul envoi exécute les variantes en parallèle. Les panneaux peuvent défiler ensemble, et la comparaison structurelle JSON identifie les valeurs ajoutées, supprimées et modifiées.

Chaque panneau correspond à une exécution réelle. Un POST, PATCH ou DELETE peut modifier les données de tous les environnements sélectionnés. Choisissez des données de test adaptées avant l'envoi. La comparaison aide à comprendre les différences, sans démontrer le comportement de toutes les opérations.

Poursuivez avec collections et partage ou import et export.