APIs › Kurdish, Arabic & Text Utilities › Template Fill

Template Fill

Fills a placeholder template from a data object with strict unresolved-placeholder reporting. Sandboxed — no expression evaluation or code execution.

POST /v1/text/template-fill $0.005 per call

Specification

Endpoint

POST /v1/text/template-fill

Price

$0.005 per call · tier basic_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · schemes exact, aggr_deferred

Data source

Deterministic local computation on caller-supplied text

Timeout

15 seconds

Max request

1 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/text/template-fill" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "result": "Dear Dana, your invoice INV-1042 totals 150000 .",
  "placeholders_found": [
    "name",
    "number",
    "total",
    "currency"
  ],
  "resolved": [
    "name",
    "number",
    "total"
  ],
  "unresolved": [
    "currency"
  ],
  "unused_data_keys": [],
  "syntax": "double_brace",
  "note": "Literal placeholder substitution only. No expression, filter, loop or conditional is evaluated, so a caller-supplied template cannot execute code."
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints