Seznam poti spletnega mesta, razdeljenih na strani, z učinkovitimi ID-ji blokov.
Prikaže seznam poti spletnega mesta, razdeljenih na strani in po potrebi filtriranih po stanju in vzorcu. Poti s praznimi block_ids se dopolnijo iz ujemajoče se dinamične privzete poti, zato so vrnjeni block_ids učinkoviti bloki za izris.
Avtorizacija: Ključ API (glava x-api-key ali parameter poizvedbe api_key).
| Parameter | Tip | Obvezno | Opombe |
|---|---|---|---|
websiteId | uuid | da | Ciljno spletno mesto. |
api_key | niz | ne | Alternativa glavi x-api-key. |
state | niz | ne | Filtriranje po stanju poti (natančno ujemanje). |
pattern | niz | ne | Ujemanje podniza v vzorcu poti (LIKE, pobegnjeni nadomestni znaki). |
limit | celo število | ne | Velikost strani, privzeto 50, omejeno na 1–100. |
offset | celo število | ne | Število preskočenih vrstic, privzeto 0. |
Rezultati so razvrščeni po updated_at DESC.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Kako začeti",
"tags": [],
"block_ids": ["..."],
"template_block_ids": ["..."],
"override_mode": "združi",
"state": "V živo",
"param_bindings": {},
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
],
"total": 42,
"hasMore": true
}
total je celotno filtrirano število; hasMore pomeni offset + limit < total. label, param_bindings, template_block_ids in override_mode so izpuščeni ali null, ko niso nastavljeni.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — manjkajoč ali neveljaven websiteId401 — neveljaven ključ API (ali manjkajoč, kadar ga strežnik zahteva)