Rivinsisäiset muuttujat kentissä

Mikä tahansa pyynnön tekstikenttä hyväksyy rivinsisäisesti kirjoitetun Handlebars-lausekkeen. Tämä on suorin tapa parametroida kutsu: mitään ei tarvitse määrittää ennalta, ja korvaus tapahtuu lähetyshetkellä.

Missä se toimii

• URL (mukaan lukien skeema, isäntä, portti ja kyselymerkkijono);
• otsakkeet, sekä avaimessa että arvossa;
• kyselyparametrit ja polkuparametrit;
• sisältö: raaka JSON, XML, lomake, x-www-form-urlencoded;
• kunkin protokollan omat kentät: MQTT-aihe, AMQP-reititysavain, gRPC-viesti, GraphQL-kysely ja sen muuttujat, Redis-komento, Kafka-avain…

Esimerkkejä

Täysin parametroitu URL:

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

Yhdistelmäotsake:

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

JSON-sisältö, joka sekoittaa muuttujia ja helpereitä:

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

MQTT-aihe ja AMQP-reititysavain:

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

Ratkaistun arvon esikatselu

Restorm näyttää asianomaisten kenttien alla ratkaistun arvon aktiivisen ympäristön mukaan. Tämä on hyvä tarkistaa ensimmäisenä, ennen kuin alkaa ihmetellä, miksi kutsu lähtee väärään URL-osoitteeseen: vastaus on lähes aina siinä nähtävissä.

Automaattinen täydennys

Ctrl+Space käynnistää automaattisen täydennyksen niissä kentissä, jotka sen hyväksyvät: se tarjoaa nykyisen ympäristön muuttujat ja Handlebars-helperit, kunkin signatuurin ja esimerkin kanssa.

Mitä on hyvä tietää

• Ratkeamaton lauseke (muuttujaa ei ole olemassa) tuottaa tyhjän merkkijonon — se ei aiheuta virhettä. Juuri siksi esikatselu on tärkeä.
• Mallipohja käännetään ilman HTML-escapausta: & tai < arvon sisällä menee läpi koskemattomana, mikä on JSON:n tai XML:n kohdalla odotettu toiminta.
• Helperit, joilla ei ole argumentteja ({{uuid}}, {{now}}, {{$randomEmail}}…), tuottavat eri arvon jokaisella lähetyksellä. Se on tarkoituksellista ja kätevää korrelaatiotunnisteille.

Täydellinen viiteopas: Handlebars-helperit.