المقدمة

نظرة عامة

تتيح لك واجهة eWasl البرمجية إنشاء المنشورات وجدولتها ونشرها برمجياً عبر عدّة منصّات. ادمج eWasl في تطبيقاتك أو سكربتاتك أو خطوط CI/CD أو مساعدي الذكاء الاصطناعي.

ما الذي يمكنك فعله

• إنشاء المنشورات — مسودّة أو جدولة أو نشر محتوى إلى Twitter/X و Instagram و LinkedIn و Facebook و TikTok و YouTube و Pinterest و Snapchat.
• عرض وتصفية المنشورات — استرجع سجل منشوراتك مع الصفحات وتصفية الحالة والمنصة.
• جدولة المنشورات — صُفّ المنشورات للنشر لاحقاً بتوصيل متدرّج ذكي.
• إدارة الاتصالات — اعرض الحسابات الاجتماعية المتصلة، وتحقّق من صحة التوكن والوصول للمنصة.
• إدارة مفاتيح API — إنشاء وعرض وإلغاء المفاتيح للوصول البرمجي.

إصدارات الواجهة

ينبغي لكل التكاملات الجديدة استخدام واجهة V1. تبقى النقاط القديمة (Legacy) عاملة لكنها لن تحصل على ميزات جديدة.

المصادقة

تتطلب كل الطلبات مفتاح API صالحاً. ضمّنه في ترويسة Authorization:

Authorization: Bearer ewasl_YOUR_API_KEY

يمكن إنشاء المفاتيح من لوحة إعدادات eWasl. راجع دليل المصادقة للتفاصيل.

حدود المعدل (Rate Limiting)

تطبّق الواجهة حدوداً للمعدل لضمان الاستخدام العادل واستقرار النظام.

عند تجاوز الحدّ، تعيد الواجهة استجابة 429 Too Many Requests مع ترويسة Retry-After تشير إلى عدد الثواني المطلوب الانتظار.

صيغة الأخطاء

تتبع كل الأخطاء غلافاً JSON موحّداً:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "وصف مقروء لما حدث.",
    "details": {}
  }
}

رموز الأخطاء الشائعة

الصفحات (Pagination)

تعيد نقاط القوائم نتائج مقسّمة على صفحات باستخدام الإزاحة (offset):

{
  "data": [ ... ],
  "meta": {
    "total": 245,
    "offset": 0,
    "limit": 50,
    "next": "/api/v1/posts?offset=50&limit=50"
  }
}

استخدم معاملي الاستعلام offset و limit للتنقّل بين الصفحات. يوفّر الحقل meta.next رابط الصفحة التالية، أو null إن لم تبقَ نتائج.

تكامل MCP

يدعم eWasl بروتوكول سياق النموذج (MCP)، ما يتيح لمساعدي الذكاء الاصطناعي مثل Claude و ChatGPT و Cursor إدارة وسائل تواصلك عبر محادثة طبيعية. راجع دليل إعداد MCP.

المنصّات المدعومة