Aller au contenu

Promenljive u liniji u poljima

Bilo koje tekstualno polje zahteva prihvata Handlebars izraz napisan u liniji. To je najdirektniji mehanizam za parametrizaciju poziva: bez prethodne konfiguracije, zamena se dešava u trenutku slanja.

  • u URL-u (uključujući šemu, host, port i upitni niz);
  • u zaglavljima, i u ključu i u vrednosti;
  • u parametrima upita i parametrima putanje;
  • u telu: sirovi JSON, XML, formular, x-www-form-urlencoded;
  • u poljima svojstvenim svakom protokolu: MQTT tema, AMQP ključ rutiranja, gRPC poruka, GraphQL upit i njegove promenljive, Redis komanda, Kafka ključ…

Potpuno parametrizovan URL:

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

Složeno zaglavlje:

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

JSON telo koje meša promenljive i helpere:

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

MQTT tema i AMQP ključ rutiranja:

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

Ispod odgovarajućih polja Restorm prikazuje razrešenu vrednost sa aktivnim okruženjem. To je refleks koji treba steći pre nego što se zapitate zašto poziv odlazi na pogrešan URL: odgovor je gotovo uvek vidljiv tu.

URL polje koje sadrži {{baseUrl}}/pet/{{petId}}, sa svojom vrednošću razrešenom aktivnim okruženjem, prikazanom neposredno ispod

Ctrl+Space pokreće automatsko dovršavanje u poljima koja ga prihvataju: nudi promenljive tekućeg okruženja i Handlebars helpere, sa njihovim potpisom i primerom.

  • Nerazrešen izraz (nepostojeća promenljiva) daje praznu nisku — ne izaziva grešku. Otud i važnost pregleda.
  • Šablon se kompajlira bez HTML eskejpovanja: & ili < u nekoj vrednosti prolazi netaknut, što je i očekivano ponašanje za JSON ili XML.
  • Helperi bez argumenata ({{uuid}}, {{now}}, {{$randomEmail}}…) proizvode različitu vrednost pri svakom slanju. To je namerno i praktično je za identifikatore korelacije.

Kompletna referenca: Handlebars helperi.