แสดงรายการเส้นทางของเว็บไซต์แบบแบ่งหน้า พร้อม `block_ids` ที่มีผลจริง.
แสดงรายการเส้นทางของเว็บไซต์แบบแบ่งหน้า และสามารถกรองตามสถานะและรูปแบบได้ตามต้องการ เส้นทางที่มี 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": "เริ่มต้นใช้งาน",
"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 ไม่ถูกต้อง (หรือไม่มีเมื่อเซิร์ฟเวอร์ต้องการ)