Vyřešte jednu trasu podle cesty URL s parametrickým párováním a ověřenými dokumenty parametrů.
Vyřeší jednu trasu pro danou cestu. Přesná shoda cesty má přednost; v opačném případě se vybere parametrický vzor s nejvyšším skóre, jeho svázané parametry se ověří vůči dokumentům a vypočítají se efektivní bloky. Volitelně vrací rozřešené dokumenty parametrů.
Autorizace: Klíč API (hlavička x-api-key nebo dotazovací parametr api_key).
| Parametr | Typ | Povinné | Poznámky |
|---|---|---|---|
websiteId | uuid | ano | Cílový web. |
path | string | ano | Cesta URL k vyřešení, např. /docs/jak-zacit. |
api_key | string | ne | Alternativa k hlavičce x-api-key. |
preview | boolean | ne | Výchozí false. Pokud je true, vyhodnocuje se proti konceptům a nevyžaduje publikované dokumenty. |
skipValidation | boolean | ne | Výchozí false. Pokud je true, selhání ověření parametrů nezpůsobí 404. |
{
"route": {
"path": "/docs/us/pruvodce",
"pattern": "/docs/{country}/pruvodce",
"block_ids": ["..."],
"state": "Aktivní",
"param_bindings": { "country": "country" }
},
"resolvedParams": {
"country": {
"value": "us",
"schemaName": "country",
"document": { "id": "...", "schema_name": "country", "title": "Spojené státy", "published_content": {} }
}
}
}
route má stejný tvar jako položka z GET /routes. resolvedParams je přítomné pouze tehdy, když má trasa vazby parametrů a byl rozřešen alespoň jeden dokument. Parametry svázané se schématem language se vyhodnocují vůči vestavěnému seznamu podporovaných jazyků místo databáze.
curl '{CMS_API_URL}/route?websiteId=<uuid>&path=/docs/jak-zacit' \
-H 'x-api-key: <key>'
400 — chybějící/neplatné websiteId, nebo chybějící/prázdná path401 — neplatný klíč API404 — trasa nenalezena nebo ověření parametrů selhalo (pokud není skipValidation=true)