التوثيق

ربط API - إدارة الموقع

أدِر الموقع عبر API

ربط API - إدارة الموقع برمجياً

مفاتيح "إدارة الموقع" (تُنشأ من لوحة التحكم > الإعدادات > الأمان) تمنح تحكماً كاملاً بالمنتجات والإضافات وإعدادات العرض دون فتح لوحة التحكم إطلاقاً - مفيدة لأتمتة النشر أو مزامنة الكتالوج من نظام آخر.

المصادقة: Authorization: Bearer <ADMIN_API_KEY>. الجسم application/json.

  • GET /api/v1/admin/products — قائمة كل المنتجات.
  • POST /api/v1/admin/products — إنشاء منتج أو تحديثه (upsert بالـslug): {"slug":"...","name_ar":"...","name_en":"...","desc_ar":"...","desc_en":"...","website_url":"...","published":true}
  • POST /api/v1/admin/products/{slug}/delete — حذف منتج (يرفض إن كان له إضافات مرتبطة).
  • GET /api/v1/admin/plugins — قائمة كل الإضافات.
  • POST /api/v1/admin/plugins — إنشاء إضافة أو تحديثها (upsert بالـslug): {"slug":"...","product_slug":"sicms","name_ar":"...","name_en":"...","desc_ar":"...","desc_en":"...","category":"...","price":0,"version":"1.0.0","published":true}
  • POST /api/v1/admin/plugins/{slug}/delete — حذف إضافة.
  • GET /api/v1/admin/settings — قراءة كل الإعدادات.
  • POST /api/v1/admin/settings — تحديث إعدادات site.* وcolor.* فقط: {"settings":{"site.tagline_ar":"..."}} (مفاتيح OAuth السرية غير متاحة عبر هذا المسار، من لوحة التحكم فقط).
curl -X POST "https://your-site/api/v1/admin/products" \
  -H "Authorization: Bearer ADMIN_API_KEY" -H "Content-Type: application/json" \
  -d '{"slug":"my-app","name_ar":"تطبيقي","name_en":"My App","published":true}'