Выводит маршруты веб-сайта с пагинацией и фактическими идентификаторами блоков.
Отображает маршруты веб-сайта, разбитые на страницы и при необходимости отфильтрованные по состоянию и шаблону. Маршруты с пустыми 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": "Getting Started",
"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 — это полное количество элементов после фильтрации; 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 (или отсутствует, если сервер требует его)