Inline-variabler

Ethvert tekstfelt på en anmodning accepterer et Handlebars-udtryk, der er skrevet inline. Det er den mest direkte måde at parametrisere et kald: ingen opsætning på forhånd, og substitutionen sker på afsendelsestidspunktet.

Hvor det virker

i URL’en (inklusive skema, host, port og query-strengen);
i headerne, både i nøglen og i værdien;
i query-parametrene og stiparametrene;
i bodyen: rå JSON, XML, formular, x-www-form-urlencoded;
i de felter, der er særlige for hver protokol: MQTT-emne (topic), AMQP-routingnøgle, gRPC-besked, GraphQL-forespørgsel og dens variabler, Redis-kommando, Kafka-nøgle…

Eksempler

En fuldt parametriseret URL:

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

En sammensat header:

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

En JSON-body, der blander variabler og helpers:

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

Et MQTT-emne og en AMQP-routingnøgle:

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

Forhåndsvisning af den resolverede værdi

Under de berørte felter viser Restorm den resolverede værdi for det aktive miljø. Det er den refleks, du skal lægge dig til, før du spekulerer på, hvorfor et kald går til en forkert URL: svaret står næsten altid lige der.

Et URL-felt, der indeholder {{baseUrl}}/pet/{{petId}}, med den værdi, det aktive miljø resolverer, vist lige nedenunder

Autofuldførelse

Ctrl+Space udløser autofuldførelse i de felter, der understøtter det: den foreslår det aktuelle miljøs variabler og Handlebars-helperne med deres signatur og et eksempel.

Det, du skal vide

Et udtryk, der ikke resolveres (en variabel, der ikke findes), giver en tom streng — det udløser ikke en fejl. Deraf betydningen af forhåndsvisningen.
Templaten kompileres uden HTML-escaping: et & eller et < i en værdi går uændret igennem, og det er den forventede adfærd for JSON eller XML.
Helpers uden argumenter ({{uuid}}, {{now}}, {{$randomEmail}}…) giver en anden værdi ved hver afsendelse. Det er med vilje, og det er praktisk til korrelations-id’er.

Fuld reference: Handlebars-helpers.