Listázza egy webhely útvonalait, lapozhatóan, effektív blokkazonosítókkal.
Listázza egy webhely útvonalait, lapozva és opcionálisan állapot, valamint minta alapján szűrve. Az üres block_ids-szel rendelkező útvonalak a megfelelő dinamikus alapértelmezett útvonalból kerülnek feltöltésre, így a visszaadott block_ids a megjelenítendő effektív blokkok.
Hitelesítés: API-kulcs (x-api-key fejléc vagy api_key lekérdezési paraméter).
| Paraméter | Típus | Kötelező | Megjegyzés |
|---|---|---|---|
websiteId | uuid | igen | Cél webhely. |
api_key | string | nem | Alternatíva az x-api-key fejlécnek. |
state | string | nem | Szűrés az útvonal állapota alapján (pontos egyezés). |
pattern | string | nem | Részsztring-egyezés az útvonal mintáján (LIKE, a helyettesítő karakterek escape-elve). |
limit | integer | nem | Oldalméret, alapértelmezés szerint 50, 1–100 közé korlátozva. |
offset | integer | nem | Kihagyandó sorok száma, alapértelmezés szerint 0. |
Az eredmények updated_at DESC szerint vannak rendezve.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Első lépések",
"tags": [],
"block_ids": ["..."],
"template_block_ids": ["..."],
"override_mode": "összefésülés",
"state": "Élő",
"param_bindings": {},
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
],
"total": 42,
"hasMore": true
}
A total a teljes, szűrt elemszám; a hasMore akkor igaz, ha offset + limit < total. A label, param_bindings, template_block_ids és override_mode mezők elhagyhatók vagy null értékűek, ha nincs beállítva.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — hiányzó vagy érvénytelen websiteId401 — érvénytelen API-kulcs (vagy hiányzik, amikor a szerver megköveteli)