Zmienne inline w polach

Dowolne pole tekstowe żądania przyjmuje wyrażenie Handlebars zapisane inline. To najbardziej bezpośredni mechanizm parametryzowania wywołania: nie wymaga żadnej wcześniejszej konfiguracji, a podstawienie następuje w chwili wysłania.

Gdzie to działa

w adresie URL (włącznie ze schematem, hostem, portem i ciągiem zapytania);
w nagłówkach, zarówno w kluczu, jak i w wartości;
w parametrach zapytania oraz parametrach ścieżki;
w treści: surowy JSON, XML, formularz, x-www-form-urlencoded;
w polach właściwych dla każdego protokołu: temat MQTT, klucz routingu AMQP, wiadomość gRPC, zapytanie GraphQL i jego zmienne, polecenie Redis, klucz Kafka…

Przykłady

Adres URL sparametryzowany w całości:

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

Nagłówek złożony z kilku części:

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

Treść JSON mieszająca zmienne z helperami:

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

Temat MQTT oraz klucz routingu AMQP:

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

Podgląd rozwiązanej wartości

Pod odpowiednimi polami Restorm wyświetla rozwiązaną wartość dla aktywnego środowiska. To pierwszy odruch, jaki warto wyrobić, zanim pojawi się pytanie, dlaczego wywołanie trafia pod zły adres URL: odpowiedź jest niemal zawsze widoczna właśnie tam.

Pole adresu URL zawierające {{baseUrl}}/pet/{{petId}}, a bezpośrednio pod nim jego wartość rozwiązana przez aktywne środowisko

Autouzupełnianie

Ctrl+Space wywołuje autouzupełnianie w polach, które je obsługują: podpowiada zmienne bieżącego środowiska oraz helpery Handlebars, wraz z ich sygnaturą i przykładem.

O czym warto wiedzieć

Nierozwiązane wyrażenie (nieistniejąca zmienna) zwraca pusty ciąg znaków — nie powoduje błędu. Stąd znaczenie podglądu.
Szablon jest kompilowany bez escapowania HTML: znak & czy < w wartości przechodzi nietknięty, co jest zachowaniem oczekiwanym dla JSON-a lub XML-a.
Helpery bez argumentów ({{uuid}}, {{now}}, {{$randomEmail}}…) dają inną wartość przy każdym wysłaniu. Jest to zamierzone i przydatne w przypadku identyfikatorów korelacji.

Pełna referencja: Helpery Handlebars.