Valeurs dynamiques

Une valeur dynamique est un jeton qu’Echolot calcule à chaque envoi de la requête : l’heure actuelle, un nouvel UUID, une signature du corps, ou une valeur de la dernière réponse d’une autre requête. Vous l’écrivez comme une variable, avec un $ devant : {{$uuid}}, {{$sha256('{{password}}')}}. Les valeurs dynamiques fonctionnent partout où les variables fonctionnent : l’URL, les paramètres, les en-têtes, le corps, les champs de formulaire et les champs d’authentification.

Cette page montre comment les ajouter et les modifier. Chaque valeur dynamique, avec ses arguments, est listée dans la référence des valeurs dynamiques.

En ajouter une depuis la listeCopy Anchor Link

1. Dans n’importe quel champ qui accepte des variables, tapez {{. Une liste s’ouvre avec d’abord les variables disponibles, puis les valeurs dynamiques par catégorie.
2. Continuez à taper pour la réduire : uuid, time, hmac. Chaque entrée indique ce qu’elle donne.
3. Déplacez-vous avec ↑ et ↓ et appuyez sur ↩ ou ⇥ pour l’insérer ; Esc ferme la liste.

Une valeur qui prend des arguments ouvre son éditeur dès que vous l’insérez : vous les remplissez dans un formulaire au lieu de les taper. Pour ouvrir la liste sans taper {{, faites un clic droit sur le champ et choisissez Insérer une variable ou une valeur….

Dans le champ, une valeur dynamique s’affiche sous forme de pastille avec un libellé lisible : le titre de la valeur (HMAC-SHA256) ou, pour une valeur de réponse, la requête et ce qu’elle lit (Sign in › $.access_token). Le texte sous-jacent reste tel qu’il est écrit.

Modifier un jetonCopy Anchor Link

Double-cliquez sur une pastille, ou faites un clic droit dessus et choisissez Modifier le jeton…. L’éditeur de jeton s’ouvre :

• Le bouton en haut indique ce qu’est le jeton et permet de le changer : une variable ou une valeur dynamique.
• Les champs sont les arguments de la valeur. Un argument de requête est un menu des requêtes de l’espace de travail, classées par dossier ; un argument de sélecteur (un JSONPath, un XPath, un nom d’en-tête) a un bouton qui liste ce que contient la dernière réponse, de sorte que vous pouvez choisir une valeur au lieu de taper son chemin.
• Valeur montre ce que le jeton donne actuellement, avec l’environnement actuel, ou Non résolu avec l’environnement actuel et pourquoi.
• Pour une variable, Utiliser une autre variable la remplace par une autre, et Utiliser plutôt une valeur de réponse la transforme en valeur de réponse.
• Retirer supprime le jeton ; Terminé garde vos modifications.

Coup d’œilCopy Anchor Link

Laissez le pointeur sur une pastille pour voir ce qu’elle donne sans l’ouvrir : la valeur (masquée pour un secret, marquée Secret), son origine et la façon dont elle est écrite. Pour les valeurs dynamiques, le coup d’œil indique quand elles sont calculées : les valeurs de temps et les valeurs aléatoires sont Recréée à chaque envoi ; ci-dessus, un exemple. Ses boutons sont Modifier…, Copier la valeur et Toutes les variables…, qui ouvre le panneau des variables.

Les écrire à la mainCopy Anchor Link

{{$name}}                       no arguments
{{$name('text', 42)}}           text in single or double quotes, numbers as they are
{{$base64(user)}}               a bare name is a variable
{{$base64('{{user}}:{{pass}}')}} variables inside text
{{$sha256("{{$requestBody('')}}")}} a dynamic value inside another one

Un jeton à l’intérieur d’un argument entre guillemets doit utiliser l’autre sorte de guillemets pour ses propres arguments : des guillemets doubles autour d’un jeton dont les arguments sont entre guillemets simples, comme dans la dernière ligne.

Ce que vous pouvez utiliserCopy Anchor Link

$env n’est pas disponible pour les agents : quand un agent IA envoie une requête, les variables d’environnement de votre Mac n’y sont pas accessibles.

L’exemple Alpenglow en utilise une dans Orders › Create order : son en-tête Idempotency-Key vaut {{$uuid}}, si bien que chaque commande est nouvelle.

Valeurs issues des réponses d’autres requêtesCopy Anchor Link

Les valeurs Réponses lisent la dernière réponse d’une autre requête enregistrée. Le premier argument est le chemin de cette requête dans l’espace de travail, son dossier et son nom comme dans les fichiers : auth/sign-in pour Auth › Sign in.

Quand la requête qu’une valeur lit n’a pas encore de réponse, Echolot l’envoie d’abord. La ligne sous la barre d’URL le signale avant l’envoi : Envoie « Sign in » d’abord. Le dernier argument, facultatif, décide quand cela se produit ; dans l’éditeur de jeton, il s’appelle L’envoyer d’abord :

{{$response('auth/sign-in', '$.access_token', 'fresh')}}

Les requêtes qui se lisent mutuellement en cercle sont refusées, avec le nom des requêtes concernées.

Pour garder une valeur d’une réponse dans une variable que toutes les requêtes lisent, plutôt que de pointer vers une seule requête, utilisez une capture de réponse.

Valeurs de cette requêteCopy Anchor Link

Les valeurs Requêtes lisent une requête telle qu’elle serait envoyée, avec ses variables et son authentification remplies. Laissez le premier argument vide pour la requête en cours d’envoi : {{$requestHeader('', 'X-Request-Id')}}. Echolot ne calcule que la partie demandée, si bien qu’un en-tête peut signer le corps :

X-Signature: {{$hmacSha256('{{signingKey}}', "{{$requestBody('')}}")}}

jqCopy Anchor Link

Les filtres jq fonctionnent dans $responseJq, $requestJq et $response(…, 'jq:…'), sans rien à installer. Un filtre qui produit plusieurs résultats les donne un par ligne :

{{$responseJq('catalog/list-products', '.items[0].sku')}}
{{$responseJq('catalog/list-products', '[.items[].price.amount] | add')}}

Quand une valeur ne se résout pasCopy Anchor Link

Un jeton qui ne peut pas être calculé (une variable manquante, une requête sans réponse qui ne peut pas être envoyée, un JSONPath qui ne trouve rien) est envoyé tel qu’il est écrit, et la ligne sous la barre d’URL affiche 1 problème. Cliquez dessus pour voir lequel. L’éditeur de jeton et le coup d’œil disent la même chose.