웹사이트의 라우트를 페이지네이션하여 나열하고, 유효한 블록 ID와 함께 제공합니다.
웹사이트의 라우트를 페이지네이션하여 나열하며, 상태와 패턴으로 선택적으로 필터링할 수 있습니다. 비어 있는 block_ids를 가진 라우트는 일치하는 dynamic-default 라우트에서 보충되므로, 반환된 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 — websiteId가 없거나 잘못되었습니다.401 — 서버에서 요구할 때 API 키가 없거나 유효하지 않습니다.