Elenca le route di un sito web, con paginazione, con gli ID di blocco effettivi.
Elenca le route di un sito web, con paginazione e, facoltativamente, filtrate per stato e pattern. Le route con block_ids vuoti vengono integrate a partire dalla route dynamic-default corrispondente, quindi i block_ids restituiti sono i blocchi effettivi da renderizzare.
Autenticazione: API key (intestazione x-api-key o parametro di query api_key).
| Parametro | Tipo | Obbligatorio | Note |
|---|---|---|---|
websiteId | uuid | sì | Sito web di destinazione. |
api_key | string | no | Alternativa all'intestazione x-api-key. |
state | string | no | Filtra per stato della route (corrispondenza esatta). |
pattern | string | no | Corrispondenza di sottostringa sul pattern della route (LIKE, caratteri jolly con escape). |
limit | integer | no | Dimensione della pagina, predefinita 50, limitata da 1–100. |
offset | integer | no | Righe da saltare, predefinito 0. |
I risultati sono ordinati per updated_at DESC.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Guida introduttiva",
"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 è il conteggio totale filtrato; hasMore è offset + limit < total. label, param_bindings, template_block_ids e override_mode vengono omessi oppure impostati a null quando non definiti.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — websiteId mancante o non valido401 — API key non valida (o mancante quando il server la richiede)