Inline variabelen in velden

Elk tekstveld van een verzoek accepteert een Handlebars-expressie die u inline schrijft. Dat is de meest directe manier om een aanroep parametriseerbaar te maken: geen configuratie vooraf, de substitutie gebeurt op het moment van verzenden.

Waar het werkt

in de URL (inclusief het schema, de host, de poort en de querystring);
in de headers, zowel in de sleutel als in de waarde;
in de queryparameters en de padparameters;
in de body: ruwe JSON, XML, formulier, x-www-form-urlencoded;
in de velden die eigen zijn aan elk protocol: MQTT-topic, AMQP-routingsleutel, gRPC-bericht, GraphQL-query en zijn variabelen, Redis-opdracht, Kafka-sleutel…

Voorbeelden

Een volledig parametriseerbare URL:

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

Een samengestelde header:

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

Een JSON-body die variabelen en helpers combineert:

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

Een MQTT-topic en een AMQP-routingsleutel:

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

Voorbeeld van de opgeloste waarde

Onder de betreffende velden toont Restorm de opgeloste waarde voor de actieve omgeving. Kijk daar eerst, voordat u zich afvraagt waarom een aanroep naar een verkeerde URL gaat: het antwoord staat er bijna altijd.

Een URL-veld met {{baseUrl}}/pet/{{petId}}, met de waarde zoals de actieve omgeving die oplost er direct onder

Automatisch aanvullen

Ctrl+Space start het automatisch aanvullen in de velden die dat ondersteunen: het biedt de variabelen van de huidige omgeving en de Handlebars-helpers aan, met hun signatuur en een voorbeeld.

Wat u moet weten

Een expressie die niet oplost (een variabele die niet bestaat) levert een lege tekenreeks op — het geeft geen fout. Vandaar het belang van het voorbeeld.
De template wordt gecompileerd zonder HTML-escaping: een & of een < in een waarde blijft intact, wat het verwachte gedrag is voor JSON of XML.
Helpers zonder argument ({{uuid}}, {{now}}, {{$randomEmail}}…) leveren bij elke verzending een andere waarde op. Dat is met opzet, en het is handig voor correlatie-identificatoren.

Volledige referentie: Handlebars-helpers.