GET /route

Rezolvă o singură rută pentru o cale dată. O potrivire exactă a căii are prioritate; altfel, este selectat cel mai bine punctat model parametric, parametrii asociați sunt validați în raport cu documentele, iar blocurile efective sunt calculate. Opțional, returnează documentele parametrilor rezolvați.

Autentificare: Cheie API (antet x-api-key sau parametru de interogare api_key).

Parametri de interogare

Răspuns

{
  "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 are aceeași structură ca o intrare din GET /routes. resolvedParams este prezent doar atunci când ruta are legări de parametri și cel puțin un document rezolvat. Parametrii legați la schema language se rezolvă pe baza unei liste integrate de limbi acceptate, nu a bazei de date.

Exemplu

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

Erori

• 400 — websiteId lipsă/invalid, sau path lipsă/gol
• 401 — cheie API invalidă
• 404 — ruta nu a fost găsită sau validarea parametrilor a eșuat (cu excepția cazului în care skipValidation=true)