الحصول على مسار

يعمل على حلّ مسار واحد لمسار معيّن. إذا وُجد تطابق تام للمسار فهو المعتمد؛ وإلا يتم اختيار النمط البارامتري الأعلى نتيجة، ثم تُتحقق المعلمات المرتبطة مقارنةً بالمستندات، وتُحسب الكتل الفعّالة. يمكنه أيضًا إرجاع مستندات المعلمات التي تم حلّها بشكل اختياري.

المصادقة: مفتاح 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)