جلب الكتل حسب المعرّف، وفق ترتيب الطلب، مع حل مراجع الصور.
جلب الكتل حسب المعرّف لموقع ويب، مع تحويل مراجع الصور إلى عناوين URL. تُعاد الكتل بنفس ترتيب معرفات ids المطلوبة؛ تُتجاهَل المعرفات غير المعروفة بصمت.
المصادقة: مفتاح واجهة برمجة التطبيقات (ترويسة x-api-key أو معامل الاستعلام api_key).
| المعامل | النوع | مطلوب | ملاحظات |
|---|---|---|---|
websiteId | uuid | لا | موقع الويب المستهدف؛ تتم الاستعاضة بترويسة Host أو الإعدادات إذا لم يحدد. |
ids | string | لا | معرّفات الكتل بصيغة UUID مفصولة بفواصل. فارغ أو غير موجود → []. |
api_key | string | لا | بديل عن ترويسة x-api-key. |
مصفوفة JSON من الكتل:
[
{
"id": "...",
"website_id": "...",
"schema_id": "...",
"draft_content": {},
"published_content": {},
"state": "published",
"version": 3,
"schema_name": "hero-block",
"layout": {},
"cloned_from_id": null,
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
]
curl '{CMS_API_URL}/blocks?websiteId=<uuid>&ids=<id1>,<id2>' \
-H 'x-api-key: <key>'
400 — UUID غير صالح في ids، أو موقع غير قابل للحل401 — مفتاح واجهة برمجة التطبيقات غير صالح