GET /route

Resuelve una única ruta para una ruta dada. Una coincidencia exacta de la ruta tiene prioridad; de lo contrario, se selecciona el patrón paramétrico con mejor puntuación, sus parámetros vinculados se validan contra los documentos y se calculan los bloques efectivos. Opcionalmente devuelve los documentos de parámetros resueltos.

Autenticación: Clave de API (encabezado x-api-key o parámetro de consulta api_key).

Parámetros de consulta

Respuesta

{
  "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 tiene la misma estructura que una entrada de GET /routes. resolvedParams solo está presente cuando la ruta tiene vinculaciones de parámetros y al menos un documento resuelto. Los parámetros vinculados al esquema language se resuelven contra una lista integrada de idiomas admitidos en lugar de la base de datos.

Ejemplo

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

Errores

• 400 — websiteId faltante o no válido, o path faltante/vacío
• 401 — clave de API no válida
• 404 — ruta no encontrada o validación de parámetros fallida (a menos que skipValidation=true)