Listet die Routen einer Website paginiert mit effektiven Block-IDs auf.
Listet die Routen einer Website auf, paginiert und optional nach Status und Muster gefiltert. Routen mit leeren block_ids werden aus der passenden dynamischen Standardroute aufgefüllt, sodass die zurückgegebenen block_ids die effektiven Blöcke zum Rendern sind.
Auth: API-Schlüssel (x-api-key-Header oder api_key-Query-Parameter).
| Parameter | Typ | Erforderlich | Hinweise |
|---|---|---|---|
websiteId | uuid | ja | Zielwebsite. |
api_key | string | nein | Alternative zum x-api-key-Header. |
state | string | nein | Filtert nach dem Routenstatus (exakte Übereinstimmung). |
pattern | string | nein | Teilzeichenfolgenabgleich auf dem Routenmuster (LIKE, Platzhalter werden maskiert). |
limit | integer | nein | Seitengröße, Standardwert 50, begrenzt auf 1–100. |
offset | integer | nein | Zu überspringende Zeilen, Standardwert 0. |
Die Ergebnisse sind nach updated_at DESC sortiert.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Erste Schritte",
"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 ist die vollständig gefilterte Anzahl; hasMore ist offset + limit < total. label, param_bindings, template_block_ids und override_mode werden ausgelassen oder sind null, wenn sie nicht gesetzt sind.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — fehlende oder ungültige websiteId401 — ungültiger API-Schlüssel (oder fehlt, wenn der Server einen verlangt)