GET /route

Визначає один маршрут для заданого шляху. Точне співпадіння шляху має пріоритет; інакше вибирається параметричний шаблон із найвищим рейтингом, його прив’язані параметри перевіряються відносно документів, а ефективні блоки обчислюються. За потреби повертає розв’язані документи параметрів.

Auth: Ключ API (заголовок x-api-key або параметр запиту api_key).

Параметри запиту

Відповідь

{
  "route": {
    "path": "/docs/us/guide",
    "pattern": "/docs/{country}/guide",
    "block_ids": ["..."],
    "state": "Live",
    "param_bindings": { "country": "country" }
  },
  "resolvedParams": {
    "country": {
      "value": "us",
      "schemaName": "country",
      "document": { "id": "...", "schema_name": "country", "title": "United States", "published_content": {} }
    }
  }
}

Об’єкт route має ту саму структуру, що й запис із GET /routes. Поле resolvedParams присутнє лише тоді, коли маршрут має прив’язки параметрів і принаймні один документ визначено. Параметри, прив’язані до схеми language, визначаються за вбудованим переліком підтримуваних мов, а не за базою даних.

Приклад

curl '{CMS_API_URL}/route?websiteId=<uuid>&path=/docs/getting-started' \
  -H 'x-api-key: <key>'

Помилки

• 400 — відсутній або некоректний websiteId, або відсутній/порожній path
• 401 — некоректний ключ API
• 404 — маршрут не знайдено або перевірка параметрів не пройдена (якщо skipValidation=true, помилка не повертається)