Изброява маршрутите на уебсайт, разделени на страници, с ефективни идентификатори на блокове.
Изброява маршрутите на уебсайт, разделени на страници и по избор филтрирани по състояние и шаблон. Маршрутите с празни block_ids се допълват от съответстващия динамичен маршрут по подразбиране, така че върнатите block_ids са ефективните блокове за визуализиране.
Удостоверяване: API ключ (x-api-key заглавка или параметър на заявката api_key).
| Параметър | Тип | Задължителен | Бележки |
|---|---|---|---|
websiteId | uuid | да | Целеви уебсайт. |
api_key | string | не | Алтернатива на заглавката x-api-key. |
state | string | не | Филтриране по състояние на маршрута (точно съответствие). |
pattern | string | не | Съвпадение по подниз в шаблона на маршрута (LIKE, специалните символи са ескейпнати). |
limit | integer | не | Размер на страницата, по подразбиране 50, ограничен в диапазона 1–100. |
offset | integer | не | Редове за пропускане, по подразбиране 0. |
Резултатите са подредени по updated_at DESC.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Първи стъпки",
"tags": [],
"block_ids": ["..."],
"template_block_ids": ["..."],
"override_mode": "merge",
"state": "Активен",
"param_bindings": {},
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
],
"total": 42,
"hasMore": true
}
total е пълният брой след филтриране; hasMore е offset + limit < total. label, param_bindings, template_block_ids и override_mode се пропускат или са null, когато не са зададени.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — липсващ или невалиден websiteId401 — невалиден API ключ (или липсва, когато сървърът изисква такъв)