GET /routes

Vypíše trasy webu, stránkované, s efektivními identifikátory bloků.

Vypíše trasy webu, stránkované a volitelně filtrované podle stavu a vzoru. Trasy s prázdným block_ids jsou doplněny z odpovídající dynamické výchozí trasy, takže vrácené block_ids představují efektivní bloky k vykreslení.

Autorizace: API klíč (hlavička x-api-key nebo dotazovací parametr api_key).

Parametry dotazu

Parametr	Typ	Povinné	Poznámky
`websiteId`	uuid	ano	Cílový web.
`api_key`	string	ne	Alternativa k hlavičce `x-api-key`.
`state`	string	ne	Filtrovat podle stavu trasy (přesná shoda).
`pattern`	string	ne	Porovnání podřetězce ve vzoru trasy (LIKE, zástupné znaky jsou escapovány).
`limit`	integer	ne	Velikost stránky, výchozí hodnota `50`, omezeno na 1–100.
`offset`	integer	ne	Počet přeskočených řádků, výchozí hodnota `0`.

Výsledky jsou seřazeny podle updated_at DESC.

Odpověď

{
  "routes": [
    {
      "website_id": "...",
      "path": "/docs/getting-started",
      "pattern": "/docs/getting-started",
      "label": "Začínáme",
      "tags": [],
      "block_ids": ["..."],
      "template_block_ids": ["..."],
      "override_mode": "merge",
      "state": "Live",
      "param_bindings": {},
      "created_at": "2026-06-23T18:34:16Z",
      "updated_at": "2026-06-23T20:36:55Z"
    }
  ],
  "total": 42,
  "hasMore": true
}

total je úplný počet po filtrování; hasMore je offset + limit < total. label, param_bindings, template_block_ids a override_mode jsou vynechány nebo mají hodnotu null, pokud nejsou nastaveny.

Příklad

curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
  -H 'x-api-key: <key>'

Chyby

400 — chybějící nebo neplatný websiteId
401 — neplatný API klíč (nebo chybějící, pokud ho server vyžaduje)

Previous‹Připojení webu k API CMS NextGET /route›