Vložené proměnné v polích

Kterékoli textové pole požadavku přijímá výraz Handlebars zapsaný vloženě. Je to nejpřímější mechanismus, jak volání parametrizovat: žádné předchozí nastavení, náhrada proběhne v okamžiku odeslání.

Kde to funguje

• v URL (včetně schématu, hostitele, portu a dotazovacího řetězce);
• v hlavičkách, jak v klíči, tak v hodnotě;
• v parametrech dotazu a v parametrech cesty;
• v těle: čisté JSON, XML, formulář, x-www-form-urlencoded;
• v polích vlastních každému protokolu: téma MQTT, směrovací klíč AMQP, zpráva gRPC, dotaz GraphQL a jeho proměnné, příkaz Redis, klíč Kafka…

Příklady

Plně parametrizovaná URL:

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

Složená hlavička:

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

Tělo JSON, které kombinuje proměnné a helpery:

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

Téma MQTT a směrovací klíč AMQP:

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

Náhled vyhodnocené hodnoty

Pod příslušnými polemi Restorm zobrazuje vyhodnocenou hodnotu s aktivním prostředím. To je reflex, který si stojí za vypěstovat, ještě než se začnete ptát, proč volání míří na špatnou URL: odpověď je téměř vždy vidět právě tam.

Automatické doplňování

Ctrl+Space spustí automatické doplňování v polích, která ho přijímají: nabídne proměnné aktuálního prostředí a helpery Handlebars, s jejich signaturou a příkladem.

Co je dobré vědět

• Nevyhodnocený výraz (neexistující proměnná) vrátí prázdný řetězec — nevyvolá chybu. Proto je náhled tak důležitý.
• Šablona se kompiluje bez escapování HTML: & nebo < v hodnotě projde neporušené, což je u JSON nebo XML očekávané chování.
• Helpery bez argumentů ({{uuid}}, {{now}}, {{$randomEmail}}…) produkují při každém odeslání jinou hodnotu. Je to záměr a hodí se to pro korelační identifikátory.

Úplný referenční přehled: Helpery Handlebars.