إدارة المحتوى
نظام إدارة محتوى بدون واجهة (Headless CMS) — API أولًا، للمطورين.
عرّف مشاريعك ومجموعاتك بحقول مكتوبة (نص، رقم، تاريخ، ملف…)، وأدر المحتوى من لوحة الورشة، ثم اعرضه في موقعك أو تطبيقك عبر مفاتيح API آمنة لكل مشروع. أنت تملك البيانات، ونحن نوفر البنية.
المفاهيم الأساسية
المشاريع
مساحة عمل واحدة لكل موقع أو تطبيق — كل مشروع له مفتاح API مستقل.
المجموعات
مثل «المقالات» أو «المنتجات» — كل مجموعة لها مخطط حقول (schema) تتحقق منه البيانات.
المدخلات
سجلات المحتوى: مسودة أثناء التحرير، ومنشورة عندما تصبح جاهزة للعرض العام.
مفاتيح API
مفتاح قراءة للعرض العام، ومفتاح كتابة للإدارة — يُعرض مرة واحدة فقط.
الباقة المجانية
مشروع واحد · 3 مجموعات لكل مشروع · 1000 مدخل لكل مشروع · حد 256KB لكل مدخل.
أنواع الحقول
| النوع | الوصف |
|---|---|
string | نص قصير (حتى 5000 حرف) |
text | نص طويل بلا حد |
number | رقم |
boolean | صح/خطأ |
date | تاريخ ISO (YYYY-MM-DD) |
asset | مرجع ملف في التخزين السحابي |
ابدأ في دقائق
من تبويب «إدارة المحتوى» في الورشة: أنشئ مشروعًا، ثم مجموعة بمخطط حقول، ثم أصدر مفتاحي قراءة وكتابة.
إنشاء مدخل (مفتاح كتابة)
curl -s -X POST https://securecelleouatine.com/api/cms/v1/myshop/collections/products/entries \
-H "Authorization: Bearer elcms_WRITE_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"iPhone 15 Pro","price":899,"in_stock":true}'استعلام المدخلات (مفتاح قراءة)
curl -s "https://securecelleouatine.com/api/cms/v1/myshop/collections/products/entries?filter[in_stock]=true&sort=price:asc&limit=10" \
-H "Authorization: Bearer elcms_READ_KEY"نشر مدخل
curl -s -X POST https://securecelleouatine.com/api/cms/v1/myshop/collections/products/entries/42/publish \
-H "Authorization: Bearer elcms_WRITE_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"published"}'المصادقة
كل طلبات واجهة المحتوى تحمل الترويسة:
Authorization: Bearer elcms_…حقول الملفات (asset)
حقل asset يخزّن مرجعًا لمفتاح كائن في التخزين السحابي (مثال: mybucket/photos/x.jpg). ارفع الملفات أولًا عبر واجهة التخزين الحالية /api/storage (التوثيق في صفحة /storage) — إدارة المحتوى تتحقق من صيغة المرجع فقط ولا تعيد تنفيذ التخزين.
الحدود والأخطاء
- تجاوز الحصة (429)
- بيانات غير صالحة (400) مع تفاصيل field_errors لكل حقل
- مفتاح مفقود أو غير صالح (401)
- صلاحية غير كافية أو مشروع مختلف (403)
- المدخل أكبر من 256KB (413)
حد الكتابة: 60 طلبًا / دقيقة لكل مفتاح.