Spec

Frammenti di codice

curl "https://api.oanor.com/uritemplate-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/uritemplate-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/uritemplate-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/uritemplate-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "name": "URI Template API",
        "notes": "Implements RFC 6570 levels 1-4. Variables may be strings, lists (arrays) or maps (objects). Undefined and empty-composite values are skipped per the spec. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/expand",
                "params": {
                    "template": "the URI template, e.g. /users/{user}{?page}",
                    "variables": "a JSON object of values"
                },
                "returns": "the expanded URI"
            },
            {
                "path": "/v1/parse",
                "params": {
                    "template": "the URI template"
                },
                "returns": "its expressions, operators and variable names"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Expand URI Templates (RFC 6570) — the standard, used by GitHub, OpenAPI/Swagger, HAL and many hypermedia APIs, for building URLs from a template and a set of variables. The expand endpoint takes a template such as /users/{user}{?page,per_page} and a JSON object of variables, and returns the finished URI with everything correctly percent-encoded. It implements all four levels of the spec: simple expansion {var}; reserved {+var} and fragment {#var} expansion; the label {.var}, path {/var}, path-style-parameter {;var}, query {?var} and query-continuation {&var} operators; multiple variables {x,y}; and the value modifiers — prefix {var:3} (first N characters) and explode {var*} (expand lists and maps element by element). Variables can be strings, lists or associative maps. The parse endpoint inspects a template and lists its expressions, operators and variable names. Everything is computed locally and deterministically, so it is instant and private. Ideal for REST and hypermedia clients, API SDKs and code generators, OpenAPI tooling, and link building. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This expands URI templates; for parsing or building query strings use a query-string API and for canonicalising URLs use a URL API."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:14.469Z",
        "request_id": "2a76e2e1-2f8a-406e-9514-e5cbe19e3c9a"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}