Hoppa till innehåll

Inline-variabler i fälten

Vilket textfält som helst i en begäran accepterar ett Handlebars-uttryck som skrivs inline. Det är det mest direkta sättet att parametrisera ett anrop: ingen förberedande konfiguration, substitutionen sker i samma stund som du skickar.

  • i URL:en (inklusive schema, värdnamn, port och frågesträng);
  • i headers, både i nyckel och i värde;
  • i frågeparametrar och sökvägsparametrar;
  • i kroppen: rå JSON, XML, formulär, x-www-form-urlencoded;
  • i de fält som hör till varje protokoll: MQTT-ämne, AMQP-routningsnyckel, gRPC-meddelande, GraphQL-fråga och dess variabler, Redis-kommando, Kafka-nyckel …

En helt parametriserad URL:

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

En sammansatt header:

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

En JSON-kropp som blandar variabler och helpers:

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

Ett MQTT-ämne och en AMQP-routningsnyckel:

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

Under de berörda fälten visar Restorm det upplösta värdet med den aktiva miljön. Det är den reflex du ska skaffa dig innan du börjar undra varför ett anrop går till fel URL: svaret syns nästan alltid där.

Ett URL-fält som innehåller {{baseUrl}}/pet/{{petId}}, med värdet upplöst av den aktiva miljön visat precis under

Ctrl+Space startar autokompletteringen i de fält som stöder den: den föreslår variablerna i den aktuella miljön och Handlebars-helpers, med signatur och ett exempel.

  • Ett uttryck som inte kan lösas upp (variabeln finns inte) ger en tom sträng — det ger inget fel. Därav vikten av förhandsvisningen.
  • Mallen kompileras utan HTML-escaping: ett & eller ett < i ett värde går igenom oförändrat, vilket är det förväntade beteendet för JSON eller XML.
  • Helpers utan argument ({{uuid}}, {{now}}, {{$randomEmail}} …) ger ett nytt värde vid varje sändning. Det är avsiktligt, och det är praktiskt för korrelations-id:n.

Fullständig referens: Handlebars-helpers.