Dynamische Werte

Ein dynamischer Wert ist ein Token, das Echolot bei jedem Senden der Anfrage berechnet: die aktuelle Zeit, eine neue UUID, eine Signatur über den Body oder ein Wert aus der neuesten Antwort einer anderen Anfrage. Du schreibst ihn wie eine Variable, mit einem $ davor: {{$uuid}}, {{$sha256('{{password}}')}}. Dynamische Werte funktionieren überall, wo Variablen funktionieren: in der URL, in Parametern, Headern, im Body, in Formularfeldern und in Auth-Feldern.

Diese Seite zeigt, wie du sie hinzufügst und bearbeitest. Jeder dynamische Wert mit seinen Argumenten steht in der Referenz der dynamischen Werte.

Aus der Liste hinzufügenCopy Anchor Link

1. Tippe in einem Feld, das Variablen annimmt, {{. Eine Liste öffnet sich, zuerst mit den Variablen im aktuellen Gültigkeitsbereich, dann mit den dynamischen Werten nach Kategorie.
2. Tippe weiter, um sie einzugrenzen: uuid, time, hmac. Jeder Eintrag sagt, was er liefert.
3. Bewege dich mit ↑ und ↓ und drücke ↩ oder ⇥, um ihn einzufügen; Esc schließt die Liste.

Ein Wert mit Argumenten öffnet seinen Editor, sobald du ihn einfügst, sodass du sie in einem Formular ausfüllst, statt sie zu tippen. Um die Liste ohne Tippen von {{ zu öffnen, klicke das Feld mit der rechten Maustaste an und wähle Variable oder Wert einfügen ….

Im Feld erscheint ein dynamischer Wert als Pille mit gut lesbarer Beschriftung: dem Titel des Werts (HMAC-SHA256) oder, bei einem Antwortwert, der Anfrage und dem, was er liest (Sign in › $.access_token). Der Text darunter bleibt, wie er geschrieben ist.

Token bearbeitenCopy Anchor Link

Doppelklicke eine Pille oder klicke sie mit der rechten Maustaste an und wähle Token bearbeiten …. Der Token-Editor öffnet sich:

• Der Knopf oben sagt, was das Token ist, und ändert es: eine Variable oder ein dynamischer Wert.
• Die Felder sind die Argumente des Werts. Ein Anfrage-Argument ist ein Menü der Anfragen des Arbeitsbereichs nach Ordnern; ein Query-Argument (ein JSONPath, ein XPath, ein Header-Name) hat einen Knopf, der auflistet, was die neueste Antwort enthält, sodass du einen Wert auswählen kannst, statt seinen Pfad zu tippen.
• Wert zeigt, was das Token jetzt mit der aktuellen Umgebung liefert, oder Lässt sich mit der aktuellen Umgebung nicht auflösen und warum.
• Bei einer Variablen tauscht Andere Variable verwenden sie gegen eine andere aus, und Stattdessen einen Antwortwert verwenden macht daraus einen Antwortwert.
• Entfernen löscht das Token; Fertig behält deine Änderungen.

KurzinfoCopy Anchor Link

Halte den Zeiger auf eine Pille, um zu sehen, was sie liefert, ohne sie zu öffnen: den Wert (bei einem Secret maskiert und als Geheim markiert), woher er kommt und wie er geschrieben ist. Bei dynamischen Werten sagt die Kurzinfo, wann sie berechnet werden: Zeit- und Zufallswerte sind Wird bei jedem Senden neu erzeugt; oben ein Beispiel. Ihre Knöpfe sind Bearbeiten …, Wert kopieren und Alle Variablen …, das das Variablen-Panel öffnet.

Von Hand schreibenCopy 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

Ein Token in einem Argument in Anführungszeichen muss für seine eigenen Argumente die andere Art Anführungszeichen nutzen: doppelte um ein Token, dessen Argumente in einfachen stehen, wie in der letzten Zeile.

Was du nutzen kannstCopy Anchor Link

$env steht Agenten nicht zur Verfügung: Sendet ein KI-Agent eine Anfrage, bleibt eine Umgebungsvariable deines Mac außen vor.

Das Alpenglow-Beispiel nutzt einen in Orders › Create order: Sein Header Idempotency-Key ist {{$uuid}}, sodass jede Bestellung neu ist.

Werte aus Antworten anderer AnfragenCopy Anchor Link

Die Werte unter Antworten lesen die neueste Antwort einer anderen gesicherten Anfrage. Das erste Argument ist der Pfad dieser Anfrage im Arbeitsbereich, ihr Ordner und ihr Name wie in den Dateien: auth/sign-in für Auth › Sign in.

Hat die Anfrage, die ein Wert liest, noch keine Antwort, sendet Echolot sie zuerst. Die Zeile unter der URL-Leiste sagt das schon vor dem Senden: Sendet zuerst „Sign in“. Das optionale letzte Argument entscheidet, wann das geschieht; im Token-Editor heißt es Zuerst senden:

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

Anfragen, die einander im Kreis lesen, werden mit Nennung der Anfragen abgelehnt.

Um einen Wert aus einer Antwort in einer Variablen zu behalten, die jede Anfrage liest, statt auf eine einzelne Anfrage zu zeigen, nutze eine Erfassung.

Werte aus dieser AnfrageCopy Anchor Link

Die Werte unter Anfragen lesen eine Anfrage so, wie sie gesendet würde, mit eingesetzten Variablen und Auth. Lass das erste Argument leer für die Anfrage, die gerade gesendet wird: {{$requestHeader('', 'X-Request-Id')}}. Echolot berechnet nur den Teil, den du verlangst, sodass ein Header den Body signieren kann:

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

jqCopy Anchor Link

jq-Filter funktionieren in $responseJq, $requestJq und $response(…, 'jq:…'), ohne dass du etwas installieren musst. Ein Filter mit mehreren Ergebnissen liefert sie zeilenweise:

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

Wenn ein Wert sich nicht auflöstCopy Anchor Link

Ein Token, das sich nicht berechnen lässt (eine fehlende Variable, eine Anfrage ohne Antwort, die sich nicht senden lässt, ein JSONPath, der nichts findet), wird unverändert gesendet, und die Zeile unter der URL-Leiste zeigt 1 Problem. Klicke darauf, um zu sehen, welches. Der Token-Editor und die Kurzinfo sagen dasselbe.