مرجع كامل لواجهة برمجة التطبيقات API Reference
| اسم المسؤول | ء |
|---|---|
| تاريخ المكاتبة | 2026-11-26 |
📚 مرجع كامل لواجهة برمجة التطبيقات API Reference
📑 فهرس المحتويات
- المصادقة والصلاحيات
- جدول كل المسارات
- فحص الحالة
- التدوينات
- الوسائط
- التصنيفات
- المجموعات
- حقول ميتا المجموعات
- ملء حقول الميتا من التدوينة
- رموز الأخطاء
- سيناريوهات كاملة
- إدارة المجتمع والمستخدمين
1️⃣ المصادقة والصلاحيات
طرق المصادقة
كل الطلبات (عدا /health) تتطلب واحدًا من:
| الطريقة | الصيغة |
|---|---|
| Header (موصى به) | Authorization: Bearer sk_xxxxxxxxxxxx |
| Header بديل | X-API-Key: sk_xxxxxxxxxxxx |
| Query (غير مستحسن) | ?api_key=sk_xxxxxxxxxxxx |
الصلاحيات المتاحة
| الصلاحية | تسمح بـ |
|---|---|
* |
كل الصلاحيات (لا يشمل الحذف — غير موجود أصلًا) |
posts:read |
قراءة التدوينات (مع بيانات المحررين) |
posts:write |
إنشاء/تحديث التدوينات (مع تعيين المحررين) |
media:read |
قراءة الوسائط |
media:write |
رفع الوسائط |
categories:read |
قراءة التصنيفات |
categories:write |
إنشاء/تحديث التصنيفات |
groups:read |
قراءة المجموعات وحقولها |
groups:write |
إنشاء/تحديث المجموعات |
groups:meta:write |
إدارة حقول ميتا المجموعات |
community:read |
قراءة المجتمع |
community:write |
إنشاء/تحديث المجتمع |
community:moderate |
إدارة النشر والاعتماد |
⚠️ مهم: لا يوجد حذف في API. كل عمليات الحذف تتم من لوحة الإدارة (/admin/posts, /admin/media, إلخ).كل ما تحتاجه للإنتاج: أنشئ مفتاحًا بـ posts:write (و community:read إن أردت جلب المحررين) وابدأ الإرسال.
