Beágyazott változók a mezőkben

Egy kérés bármelyik szöveges mezője elfogad beágyazottan írt Handlebars-kifejezést. Ez a leggyorsabb módja egy hívás paraméterezésének: nincs előzetes konfiguráció, a behelyettesítés a küldés pillanatában történik.

Hol működik

• az URL (a sémát, a hosztot, a portot és a lekérdezési karakterláncot is beleértve);
• a fejlécek, kulcsban és értékben egyaránt;
• a kérésparaméterek és az útvonalparaméterek;
• a törzs: nyers JSON, XML, űrlap, x-www-form-urlencoded;
• az egyes protokollokra jellemző mezők: MQTT-téma, AMQP-útválasztási kulcs, gRPC-üzenet, GraphQL-lekérdezés és annak változói, Redis-parancs, Kafka-kulcs…

Példák

Egy teljesen paraméterezett URL:

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

Egy összetett fejléc:

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

Egy JSON-törzs, amely változókat és helpereket kever:

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

Egy MQTT-téma és egy AMQP-útválasztási kulcs:

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

A feloldott érték előnézete

Az érintett mezők alatt a Restorm megjeleníti az aktív környezettel feloldott értéket. Ezt érdemes reflexszerűen megnézni, mielőtt felmerül a kérdés, hogy egy hívás miért indul rossz URL-re: a válasz szinte mindig ott látszik.

Automatikus kiegészítés

A Ctrl+Space az azt támogató mezőkben automatikus kiegészítést indít: felajánlja az aktuális környezet változóit és a Handlebars-helpereket, a szignatúrájukkal és egy példával együtt.

Amit tudni kell

• A fel nem oldott kifejezés (nem létező változó) üres karakterláncot ad — nem okoz hibát. Ezért is fontos az előnézet.
• A sablon HTML-escape nélkül kerül lefordításra: egy & vagy egy < az értékben érintetlenül átmegy, ami JSON vagy XML esetén az elvárt viselkedés.
• Az argumentum nélküli helperek ({{uuid}}, {{now}}, {{$randomEmail}}…) minden küldésnél más értéket állítanak elő. Ez szándékos, és jól jön korrelációs azonosítókhoz.

Teljes referencia: Handlebars-helperek.