Καταγράψτε τις διαδρομές ενός ιστότοπου, με σελιδοποίηση, με τα πραγματικά αναγνωριστικά block.
Καταγράψτε τις διαδρομές ενός ιστότοπου, με σελιδοποίηση και προαιρετικό φιλτράρισμα κατά κατάσταση και μοτίβο. Οι διαδρομές με κενά block_ids συμπληρώνονται από την αντίστοιχη διαδρομή δυναμικής προεπιλογής, επομένως τα επιστρεφόμενα block_ids είναι τα πραγματικά blocks προς απόδοση.
Ταυτοποίηση: Κλειδί API (κεφαλίδα x-api-key ή παράμετρος ερωτήματος api_key).
| Παράμετρος | Τύπος | Υποχρεωτική | Σημειώσεις |
|---|---|---|---|
websiteId | uuid | ναι | Στόχος ιστότοπου. |
api_key | string | όχι | Εναλλακτική στην κεφαλίδα x-api-key. |
state | string | όχι | Φιλτράρισμα κατά κατάσταση διαδρομής (ακριβής αντιστοίχιση). |
pattern | string | όχι | Αντιστοίχιση υποσυμβολοσειράς στο μοτίβο διαδρομής (LIKE, με αποδιαφυγή των μπαλαντέρ). |
limit | integer | όχι | Μέγεθος σελίδας, προεπιλογή 50, περιορίζεται στο 1–100. |
offset | integer | όχι | Γραμμές προς παράλειψη, προεπιλογή 0. |
Τα αποτελέσματα ταξινομούνται κατά updated_at DESC.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Ξεκινώντας",
"tags": [],
"block_ids": ["..."],
"template_block_ids": ["..."],
"override_mode": "merge",
"state": "Ενεργό",
"param_bindings": {},
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
],
"total": 42,
"hasMore": true
}
Το total είναι το πλήρες φιλτραρισμένο πλήθος· το hasMore ισούται με offset + limit < total. Τα label, param_bindings, template_block_ids και override_mode παραλείπονται ή είναι null όταν δεν έχουν οριστεί.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — λείπει ή μη έγκυρο websiteId401 — μη έγκυρο κλειδί API (ή λείπει όταν ο διακομιστής απαιτεί ένα)