Inline-variabler i feltene

Alle tekstfelt i en forespørsel godtar et Handlebars-uttrykk skrevet inline. Det er den mest direkte måten å parametrisere et kall på: ingen forhåndskonfigurasjon, og substitusjonen skjer i det øyeblikket forespørselen sendes.

Hvor det virker

• i URLen (inkludert skjema, vert, port og spørringsstrengen);
• i headerne, både nøkkel og verdi;
• i spørringsparameterne og stiparameterne;
• i kroppen: rå JSON, XML, skjema, x-www-form-urlencoded;
• i feltene som hører til den enkelte protokollen: MQTT-emne, AMQP-rutingnøkkel, gRPC-melding, GraphQL-forespørsel og variablene dens, Redis-kommando, Kafka-nøkkel …

Eksempler

En fullt parametrisert URL:

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

En sammensatt header:

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

En JSON-kropp som blander variabler og helpere:

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

Et MQTT-emne og en AMQP-rutingnøkkel:

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

Forhåndsvisning av den oppløste verdien

Under de aktuelle feltene viser Restorm den oppløste verdien for det aktive miljøet. Det er dette du bør se på før du begynner å lure på hvorfor et kall går mot feil URL: svaret er nesten alltid synlig der.

Autofullføring

Ctrl+Space utløser autofullføring i de feltene som støtter det: den foreslår variablene i det gjeldende miljøet og Handlebars-helperne, med signatur og et eksempel.

Ting du bør vite

• Et uttrykk som ikke kan løses opp (en variabel som ikke finnes), gir en tom streng — det utløser ingen feil. Derfor er forhåndsvisningen så viktig.
• Malen kompileres uten HTML-escaping: en & eller en < i en verdi går uendret gjennom, som er den forventede oppførselen for JSON eller XML.
• Helpere uten argumenter ({{uuid}}, {{now}}, {{$randomEmail}} …) gir en ny verdi for hver sending. Det er tilsiktet, og det er praktisk for korrelasjons-IDer.

Fullstendig referanse: Handlebars-helpere.