profound-logoProfound CMS
⌘K
Admin
Theme
Docsبرنامج تعليميBlogPhilosophy
Docsبرنامج تعليميBlogPhilosophy

Hybrid

التوجيه البارامتريTypes of Componentsإس إس إيInstall Profound CMS as a proxyالبرمجة النصية في منشئ القوالبProject Scaffoldingمكتبة الوسائط

بلا رأس

البدء السريعJSON و Claude CodeComponent Zod Pull

واجهة برمجة تطبيقات REST

نظرة عامة على واجهة RESTgetربط موقع الويب بواجهة برمجة التطبيقاتgetالحصول على المساراتgetالحصول على مسارgetالحصول على الكتلgetجلب الكتل مع ذاكرة CEL المؤقتةgetGET /blocks/generatedgetالحصول على المكوناتgetGET /components/{name}getالحصول على اسم مخطط مجموعة البياناتgetالحصول على تغييرات المحتوى (SSE)patchPATCH /dataset/{schema_name}postترجمة المنشورpatchPATCH /translationsgetالحصول على الاستخدامpostPOST /csvpatchPATCH /csv
All Systems Operational
Powered Byprofound-logo
Theme

GET /blocks/generated

اجلب المحتوى والتخطيط المولَّدين بالذكاء الاصطناعي لمجموعة من معرّفات الكتل.

اجلب المحتوى والتخطيط المولَّدين بالذكاء الاصطناعي لمعرّفات الكتل المعطاة من جدول generated_blocks.

المصادقة: مفتاح واجهة برمجة التطبيقات (x-api-key في الترويسة أو معامل الاستعلام api_key).

معاملات الاستعلام

المعاملالنوعمطلوبملاحظات
websiteIduuidلاالموقع المستهدف؛ يعود إلى ترويسة Host أو الإعداد. لا يتم التحقق منه إلا عندما تكون blockIds غير فارغة.
blockIdsstringلامعرّفات كتل UUID مفصولة بفواصل. فارغ أو مفقود → كائن فارغ.
api_keystringلابديل لترويسة x-api-key.

الاستجابة

{
  "generatedBlocks": {
    "<block_id>": {
      "id": "...",
      "generated_content": {},
      "generated_layout": {},
      "schema_name": "hero-block",
      "status": "ready"
    }
  }
}

يُفهرس المخطط الخارجي حسب block_id المطلوب؛ أما id الداخلي فهو معرّف الصف المولَّد نفسه.

مثال

curl '{CMS_API_URL}/blocks/generated?websiteId=<uuid>&blockIds=<id1>,<id2>' \
  -H 'x-api-key: <key>'

الأخطاء

  • 400 — معرّف UUID غير صالح في blockIds، أو موقع لا يمكن حله
  • 401 — مفتاح واجهة برمجة تطبيقات غير صالح
Continue Reading
Previous‹جلب الكتل مع ذاكرة CEL المؤقتةNextالحصول على المكونات›