Aller au contenu

Variablat në rresht brenda fushave

Çdo fushë teksti e një kërkese pranon një shprehje Handlebars të shkruar në rresht. Ky është mekanizmi më i drejtpërdrejtë për të parametrizuar një thirrje: pa konfigurim paraprak, zëvendësimi ndodh në çastin e dërgimit.

  • te URL-ja (përfshirë skemën, hostin, portin dhe vargun e kërkesës);
  • te kokat, si në çelës ashtu edhe në vlerë;
  • te parametrat e kërkesës dhe parametrat e shtegut;
  • te trupi: JSON i papërpunuar, XML, formular, x-www-form-urlencoded;
  • te fushat specifike të çdo protokolli: tema MQTT, çelësi i rrugëzimit AMQP, mesazhi gRPC, kërkesa GraphQL dhe variablat e saj, komanda Redis, çelësi Kafka…

Një URL plotësisht e parametrizuar:

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

Një kokë e përbërë:

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

Një trup JSON që përzien variabla dhe helper-a:

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

Një temë MQTT dhe një çelës rrugëzimi AMQP:

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

Nën fushat përkatëse, Restorm shfaq vlerën e zgjidhur me mjedisin aktiv. Ky është refleksi që duhet fituar përpara se të pyesni veten pse një thirrje niset drejt një URL-je të gabuar: përgjigjja është pothuajse gjithmonë e dukshme aty.

Një fushë URL që përmban {{baseUrl}}/pet/{{petId}}, me vlerën e saj të zgjidhur nga mjedisi aktiv të shfaqur pikërisht poshtë

Ctrl+Space nis vetëplotësimin në fushat që e pranojnë: ai propozon variablat e mjedisit aktual dhe helper-at Handlebars, me nënshkrimin e tyre dhe një shembull.

  • Një shprehje e pazgjidhur (variabël inekzistente) jep një varg bosh — ajo nuk shkakton gabim. Prej këtu edhe rëndësia e parapamjes.
  • Gjedhja përpilohet pa ikje HTML: një & ose një < brenda një vlere kalon i paprekur, gjë që është sjellja e pritur për JSON ose XML.
  • Helper-at pa argumente ({{uuid}}, {{now}}, {{$randomEmail}}…) prodhojnë një vlerë të ndryshme në çdo dërgim. Kjo është e qëllimshme dhe shumë praktike për identifikuesit e korrelacionit.

Referenca e plotë: Helper-at Handlebars.