Zum Inhalt springen

Inline-Variablen in Feldern

Jedes Textfeld einer Anfrage akzeptiert einen inline geschriebenen Handlebars-Ausdruck. Das ist der direkteste Mechanismus, um einen Aufruf zu parametrisieren: keine vorherige Konfiguration, die Ersetzung erfolgt im Moment des Sendens.

  • die URL (einschließlich Schema, Host, Port und Query-String);
  • die Header, sowohl als Schlüssel als auch als Wert;
  • die Query-Parameter und die Pfadparameter;
  • der Body: rohes JSON, XML, Formular, x-www-form-urlencoded;
  • die protokollspezifischen Felder: MQTT-Sujet, AMQP-Routing-Key, gRPC-Nachricht, GraphQL-Anfrage und ihre Variablen, Redis-Befehl, Kafka-Key …

Eine vollständig parametrisierte URL:

{{scheme}}://{{host}}:{{port}}/v{{apiVersion}}/clients/{{clientId}}

Ein zusammengesetzter Header:

Authorization: Bearer {{accessToken}}
X-Request-Id: {{uuid}}

Ein JSON-Body, der Variablen und Helper mischt:

{
"reference": "CMD-{{timestamp}}",
"client": "{{clientId}}",
"libelle": "{{uppercase produit}}",
"montant": {{multiply prixUnitaire quantite}},
"creeLe": "{{now}}"
}

Ein MQTT-Sujet und ein AMQP-Routing-Key:

capteurs/{{site}}/{{capteurId}}/mesures
commandes.{{pays}}.creees

Unter den betroffenen Feldern zeigt Restorm den aufgelösten Wert mit der aktiven Umgebung an. Das ist der erste Reflex, bevor Sie sich fragen, warum ein Aufruf an einer falschen URL landet: Die Antwort ist fast immer dort sichtbar.

Ein URL-Feld mit dem Inhalt {{baseUrl}}/pet/{{petId}}, darunter der durch die aktive Umgebung aufgelöste Wert

Ctrl+Space löst in den Feldern, die es unterstützen, die Autovervollständigung aus: Sie schlägt die Variablen der aktuellen Umgebung und die Handlebars-Helper vor, jeweils mit Signatur und Beispiel.

  • Ein nicht auflösbarer Ausdruck (nicht existierende Variable) ergibt eine leere Zeichenkette – er verursacht keinen Fehler. Daher die Bedeutung der Vorschau.
  • Das Template wird ohne HTML-Escaping kompiliert: Ein & oder < in einem Wert bleibt unverändert erhalten, was für JSON oder XML das erwartete Verhalten ist.
  • Argumentlose Helper ({{uuid}}, {{now}}, {{$randomEmail}} …) liefern bei jedem Senden einen anderen Wert. Das ist beabsichtigt und praktisch für Korrelations-IDs.

Vollständige Referenz: Handlebars-Helper.