רשימת מסלולי אתר אינטרנט, בפג'ינציה, עם מזהי בלוקים אפקטיביים.
צרו רשימה של מסלולי האתר עם פג'ינציה ואפשרות לסינון לפי מצב ותבנית. מסלולים שבהם 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 — websiteId חסר או לא תקין401 — מפתח API לא תקין (או חסר כאשר השרת דורש אחד)