Wyświetla listę tras witryny, stronicowaną, z efektywnymi identyfikatorami bloków.
Wyświetla listę tras witryny, stronicowaną i opcjonalnie filtrowaną według stanu oraz wzorca. Trasy z pustymi block_ids są uzupełniane na podstawie pasującej dynamicznej trasy domyślnej, więc zwracane block_ids to efektywne bloki do renderowania.
Uwierzytelnianie: Klucz API (nagłówek x-api-key lub parametr zapytania api_key).
| Parametr | Typ | Wymagany | Uwagi |
|---|---|---|---|
websiteId | uuid | tak | Docelowa witryna. |
api_key | string | nie | Alternatywa dla nagłówka x-api-key. |
state | string | nie | Filtruj według stanu trasy (dokładne dopasowanie). |
pattern | string | nie | Dopasowanie podciągu względem wzorca trasy (LIKE, znaki wieloznaczne są eskapowane). |
limit | integer | nie | Rozmiar strony, domyślnie 50, ograniczony do zakresu 1–100. |
offset | integer | nie | Liczba wierszy do pominięcia, domyślnie 0. |
Wyniki są sortowane według updated_at DESC.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Pierwsze kroki",
"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 to pełna, przefiltrowana liczba rekordów; hasMore oznacza offset + limit < total. Pola label, param_bindings, template_block_ids i override_mode są pomijane lub mają wartość null, jeśli nie zostały ustawione.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — brakujące lub nieprawidłowe websiteId401 — nieprawidłowy klucz API (lub brak, gdy serwer go wymaga)