Templates on spectralab

Variables

Mon, 01 Jan 0001 00:00:00 +0000

Template Variables#

When template: true is set on a response, the response body and header values are rendered as a Go template. These variables are available:

Variable	Description
`{{.UUID}}`	UUID v4 — unique per request
`{{.Now}}`	Current time in RFC3339 format
`{{.Timestamp}}`	Current Unix timestamp (seconds)
`{{.RequestID}}`	Unique request ID (also logged)
`{{.Method}}`	Incoming HTTP method
`{{.Path}}`	Incoming URL path
`{{.Body}}`	Raw request body

Example#

id: order-created
method: POST
path: /webhooks/orders
response:
 status_code: 200
 template: true
 headers:
 X-Request-ID: "{{.RequestID}}"
 X-Timestamp: "{{.Now}}"
 body: '{"id":"{{.UUID}}","event":"order.created","timestamp":{{.Timestamp}},"method":"{{.Method}}","body":"{{.Body}}"}'

Send a request:

Functions

Mon, 01 Jan 0001 00:00:00 +0000

Template Functions#

Beyond the request variables, templates can call functions — either built-in request helpers or random generators.

Request Helpers#

Function	Description
`{{Header "X-Key"}}`	Value of a request header (empty string if absent).
`{{Query "param"}}`	Value of a query parameter (empty string if absent).

Random Helpers#

Function	Description
`{{RandomInt 1 100}}`	Random integer in the inclusive range.
`{{RandomHex 8}}`	Random hex string of the given length.

The full set of realistic random data generators — {{Name}}, {{Email}}, {{Company}}, etc. — is on the Faker Generators page.

Faker Generators

Mon, 01 Jan 0001 00:00:00 +0000

Faker Data Generators#

Simuhook ships a curated set of 27 realistic random data generators, powered by gofakeit. Each call renders a realistic random value — a name, an email, a price — so your mock responses look like data from a real third-party service. All generators are thread-safe and return a fresh value per render.

Person#

Function	Example output
`{{Name}}`	`Markus Moen`
`{{FirstName}}`	`Fred`
`{{LastName}}`	`Moen`
`{{Email}}`	`alaynawuckert@kozey.biz`
`{{Phone}}`	`(570)245-7485`

Address#

Function	Example output
`{{City}}`	`Lake Maxine`
`{{Country}}`	`Canada`
`{{State}}`	`Nebraska`
`{{Zip}}`	`38762`
`{{Street}}`	`98789 Hane Locks`

Company#

Function	Example output
`{{Company}}`	`Moen, Pagac and Wuckert`
`{{JobTitle}}`	`Director`

Internet#

Function	Example output
`{{IPv4Address}}`	`192.168.1.42`
`{{IPv6Address}}`	`2001:db8::1`
`{{DomainName}}`	`kozey.biz`
`{{MACAddress}}`	`ab:cd:ef:01:23:45`
`{{UserAgent}}`	`Mozilla/5.0 …`

Payment#

Function	Example output
`{{CreditCardNumber}}`	`4287271570245748`
`{{Price}}`	`42.99`

Product & ID#

Function	Example output
`{{ProductName}}`	`Incredible Metal Chair`
`{{ULID}}`	`pfsfktb87rcmj6bqha2fz9`
`{{UUID}}`	`0d1e6f2a-…`

Text & Misc#

Function	Example output
`{{Word}}`	`river`
`{{Sentence}}`	`Record river mind.`
`{{Paragraph}}`	`Quia voluptatem…`
`{{HexColor}}`	`#a3e4f2`
`{{Bool}}`	`true`

Example — Webhook-Shaped Response#

id: customer-created
method: POST
path: /webhooks/customer
response:
 status_code: 200
 template: true
 body: '{"event":"customer.created","customer":{"id":"{{UUID}}","name":"{{Name}}","email":"{{Email}}","address":{"city":"{{City}}","country":"{{Country}}"}},"payment":{"card":"{{CreditCardNumber}}","amount":"{{Price}}","currency":"USD"}}'

Each request returns a full, realistic customer profile:

JSONPath

Mon, 01 Jan 0001 00:00:00 +0000

JSONPath#

{{JSONPath "$…"}} extracts a field from the JSON request body. The body is parsed once per request; {{.Body}} still renders the full raw body string.

Syntax#

Path	Meaning
`$`	The whole request body (as JSON string)
`$.user`	Object key `user`
`$.user.name`	Nested object key
`$.items[0]`	Array index 0
`$.items[0].name`	Nested into an array element
`$.items[1].tags[0]`	Deeper nesting

Return Semantics#

Value	Renders as
String	Unquoted (`Ada`)
Number	Unquoted (`42`, `42.5`)
Boolean	`true` / `false`
`null`	`null`
Object / array	Compact JSON (`{"a":1}`)
Missing path, out-of-bounds index, non-JSON body	Empty string (no panic, no fallback)

Example#

id: customer-echo
method: POST
path: /webhooks/customer-echo
response:
 status_code: 200
 template: true
 body: '{"received":{"id":"{{JSONPath "$.customer.id"}}","name":"{{JSONPath "$.customer.name"}}"},"full_payload":{{JSONPath "$"}}}'

Send a request: