وثائق مطوري eWasl
دليل مطوّر eWasl — REST API وخادم MCP ومقاطع SDK جاهزة للنسخ، مصمَّم لجدولة المحتوى العربي.
أهلاً بك في وثائق المطوّرين. eWasl يوفر ثلاث طرق للتكامل: REST API عمومي، وخادم MCP لوكلاء الذكاء الاصطناعي، ومقاطع جاهزة للنسخ في الكود. اختر مسارك من الأدناه.
English: Switch to the English documentation for the full reference (the API and MCP guides themselves are kept in English to match the underlying endpoint contracts).
بداية سريعة
إنشاء مفتاح API
أنشئ مفتاحاً من لوحة التحكم، انسخه مرة واحدة، وابدأ النشر خلال دقيقة.
جدولة أول منشور
POST واحد إلى /v1/posts/schedule ونحن نتولى النشر — تويتر، إنستغرام، تيك توك، لينكدإن، فيسبوك، يوتيوب.
ربط وكيل ذكاء اصطناعي
ادمج eWasl مع Claude أو Cursor أو ChatGPT أو أي عميل متوافق مع MCP. الخادم يوفر ١١ أداة.
الاشتراك بالـ Webhooks
استلم أحداث post.published و post.failed مع توقيع HMAC للتحقق.
REST API الأساسي
المقدمة
الـ Base URL وهيكل الأخطاء وحدود المعدل و idempotency.
المصادقة
إنشاء وتدوير وإلغاء مفاتيح API. صيغة Bearer header.
إنشاء منشور
POST /v1/posts — نشر فوري أو مجدول عبر المنصات.
جدولة منشور
POST /v1/posts/schedule — توصيل متدرج + تعليقات لكل منصة.
قائمة المنشورات
GET /v1/posts — صفحات، تصفية بالحالة / المنصة.
الحسابات المتصلة
GET /v1/connections — الحسابات المرتبطة وحالة التوكن.
مفاتيح API
إنشاء وعرض وإلغاء المفاتيح برمجياً.
Webhooks
أحداث post.published و post.failed مع HMAC.
MCP لوكلاء الذكاء الاصطناعي
نظرة عامة على MCP
ما هو خادم eWasl MCP وقائمة الـ ١١ أداة التي يقدّمها.
Claude Desktop
جسر stdio عبر mcp-remote — إعدادات جاهزة للنسخ.
Cursor
HTTP MCP أصلي — الصق الرابط وأنشئ مفتاحاً.
ChatGPT
إعداد Custom GPT Action عبر مخطط OpenAPI.
Windsurf
إعدادات Cascade MCP server.
الدعم والـ SLA
- حالة الخدمة: https://app.ewasl.com/status
- البريد: support@ewasl.com — أول رد خلال ساعات العمل.
- المشكلات / الـ bugs: github.com/TahaOsa/ewasl-social-scheduler/issues
- لوحة التحكم: app.ewasl.com