Liệt kê các tuyến của một trang web, phân trang, với các block ID có hiệu lực.
Liệt kê các tuyến của một trang web, phân trang và tùy chọn lọc theo trạng thái và mẫu. Các tuyến có block_ids trống được điền từ tuyến dynamic-default tương ứng, vì vậy các block_ids được trả về là các khối có hiệu lực để kết xuất.
Xác thực: Khóa API (header x-api-key hoặc tham số truy vấn api_key).
| Tham số | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
websiteId | uuid | có | Trang web mục tiêu. |
api_key | string | không | Lựa chọn thay thế cho header x-api-key. |
state | string | không | Lọc theo trạng thái của tuyến (khớp chính xác). |
pattern | string | không | Khớp chuỗi con trên mẫu tuyến (LIKE, ký tự đại diện đã được escape). |
limit | integer | không | Kích thước trang, mặc định 50, giới hạn trong khoảng 1–100. |
offset | integer | không | Số hàng bỏ qua, mặc định 0. |
Kết quả được sắp xếp theo updated_at DESC.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Bắt đầu",
"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 là tổng số sau khi lọc; hasMore là offset + limit < total. label, param_bindings, template_block_ids và override_mode được lược bỏ hoặc bằng null khi chưa được thiết lập.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — thiếu hoặc websiteId không hợp lệ401 — khóa API không hợp lệ (hoặc thiếu khi máy chủ yêu cầu)