Biến nội tuyến trong các trường

Bất kỳ trường văn bản nào của một yêu cầu cũng chấp nhận một biểu thức Handlebars viết nội tuyến. Đây là cơ chế trực tiếp nhất để tham số hóa một lời gọi: không cần cấu hình trước, phép thay thế diễn ra ngay lúc gửi.

Nơi cơ chế này hoạt động

• URL (bao gồm cả lược đồ, host, cổng và chuỗi truy vấn);
• các header, cả ở khóa lẫn ở giá trị;
• các tham số truy vấn và tham số đường dẫn;
• thân: JSON thô, XML, biểu mẫu, x-www-form-urlencoded;
• các trường riêng của từng giao thức: topic MQTT, khóa định tuyến AMQP, thông điệp gRPC, truy vấn GraphQL và các biến của nó, lệnh Redis, khóa Kafka…

Ví dụ

Một URL được tham số hóa hoàn toàn:

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

Một header ghép:

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

Một thân JSON trộn lẫn biến và helper:

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

Một topic MQTT và một khóa định tuyến AMQP:

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

Xem trước giá trị đã giải quyết

Ngay dưới các trường liên quan, Restorm hiển thị giá trị đã giải quyết theo môi trường đang hoạt động. Đây là phản xạ cần tạo trước khi tự hỏi vì sao một lời gọi lại đi tới URL sai: câu trả lời gần như luôn nằm ngay đó.

Tự động hoàn thành

Ctrl+Space kích hoạt tính năng tự động hoàn thành trong những trường có hỗ trợ: nó gợi ý các biến của môi trường hiện tại và các helper Handlebars, kèm chữ ký và một ví dụ.

Những điều cần biết

• Một biểu thức không giải quyết được (biến không tồn tại) trả về chuỗi rỗng — nó không gây lỗi. Vì thế phần xem trước rất quan trọng.
• Mẫu được biên dịch không thoát HTML: một dấu & hay < trong một giá trị sẽ đi qua nguyên vẹn, đúng như hành vi mong đợi với JSON hay XML.
• Các helper không đối số ({{uuid}}, {{now}}, {{$randomEmail}}…) tạo ra một giá trị khác nhau ở mỗi lần gửi. Điều đó là cố ý, và rất tiện cho các định danh tương quan.

Tham chiếu đầy đủ: Helper Handlebars.