Variabile inline în câmpuri

Orice câmp text al unei cereri acceptă o expresie Handlebars scrisă inline. Este mecanismul cel mai direct de parametrizare a unui apel: nicio configurare prealabilă, substituția are loc în momentul trimiterii.

Unde funcționează

în URL (inclusiv schema, gazda, portul și șirul de interogare);
în antete, atât în cheie, cât și în valoare;
în parametrii de interogare și în parametrii de cale;
în corp: JSON brut, XML, formular, x-www-form-urlencoded;
în câmpurile specifice fiecărui protocol: subiect MQTT, cheie de rutare AMQP, mesaj gRPC, interogare GraphQL și variabilele sale, comandă Redis, cheie Kafka…

Exemple

Un URL complet parametrizat:

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

Un antet compozit:

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

Un corp JSON care amestecă variabile și helperi:

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

Un subiect MQTT și o cheie de rutare AMQP:

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

Previzualizarea valorii rezolvate

Sub câmpurile în cauză, Restorm afișează valoarea rezolvată cu mediul activ. Este reflexul de dobândit înainte să vă întrebați de ce un apel pleacă spre un URL greșit: răspunsul este aproape întotdeauna vizibil acolo.

Un câmp URL care conține {{baseUrl}}/pet/{{petId}}, cu valoarea sa rezolvată de mediul activ afișată imediat dedesubt

Autocompletare

Ctrl+Space declanșează autocompletarea în câmpurile care o acceptă: propune variabilele mediului curent și helperii Handlebars, cu semnătura lor și un exemplu.

Ce trebuie știut

O expresie nerezolvată (variabilă inexistentă) produce un șir vid — nu provoacă o eroare. De aici importanța previzualizării.
Șablonul este compilat fără eludare HTML: un & sau un < dintr-o valoare trece intact, ceea ce este comportamentul așteptat pentru JSON sau XML.
Helperii fără argument ({{uuid}}, {{now}}, {{$randomEmail}}…) produc o valoare diferită la fiecare trimitere. Este voit și este practic pentru identificatorii de corelare.

Referință completă: Helperi Handlebars.