Répertorie les routes d'un site web, paginées, avec des identifiants de blocs effectifs.
Répertorie les routes d'un site web, paginées et éventuellement filtrées par état et motif. Les routes dont block_ids est vide sont complétées à partir de la route dynamique par défaut correspondante, de sorte que les block_ids renvoyés sont les blocs effectifs à rendre.
Authentification : Clé API (en-tête x-api-key ou paramètre de requête api_key).
| Paramètre | Type | Obligatoire | Remarques |
|---|---|---|---|
websiteId | uuid | oui | Site web cible. |
api_key | chaîne | non | Alternative à l'en-tête x-api-key. |
state | chaîne | non | Filtrer par état de la route (correspondance exacte). |
pattern | chaîne | non | Correspondance de sous-chaîne sur le motif de la route (LIKE, caractères génériques échappés). |
limit | entier | non | Taille de page, valeur par défaut 50, bornée entre 1 et 100. |
offset | entier | non | Lignes à ignorer, valeur par défaut 0. |
Les résultats sont triés par updated_at DESC.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Prise en main",
"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 correspond au nombre total filtré ; hasMore vaut offset + limit < total. label, param_bindings, template_block_ids et override_mode sont omis ou null lorsqu'ils ne sont pas définis.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — websiteId manquant ou invalide401 — Clé API invalide (ou absente lorsque le serveur en exige une)