جديد: استوديو كواملي AI متاح الآن — أنشئ روبوتات ذكية في دقائق.اكتشف →
الموارد

مرجع REST API

ابنِ تكاملات مخصصة مع كواملي ميديا. API كامل بمعايير REST و OAuth 2.0، يدعم Webhooks للأحداث الحية.

مرجع REST API

Base URL

https://app.kwamlemedia.com/api/v1

المصادقة (Authentication)

جميع الطلبات تتطلب رمز Bearer Token في الـ header:

Authorization: Bearer YOUR_API_TOKEN

احصل على رمزك من Settings → API Keys.

الروبوتات (Bots)

GET/bots
قائمة بجميع روبوتاتك.
GET/bots/{id}
تفاصيل روبوت محدد.
POST/bots
إنشاء روبوت جديد.
PATCH/bots/{id}
تعديل بيانات روبوت.
DELETE/bots/{id}
حذف روبوت.

المشتركون (Subscribers)

GET/subscribers
قائمة المشتركين مع pagination.
GET/subscribers/{id}
بيانات مشترك محدد.
POST/subscribers/{id}/messages
إرسال رسالة لمشترك معيّن.
POST/subscribers/{id}/tags
إضافة تصنيف لمشترك.

المنشورات (Posts)

GET/posts
قائمة المنشورات المجدولة والمنشورة.
POST/posts
إنشاء/جدولة منشور جديد.

المتجر (Ecommerce)

GET/products
قائمة المنتجات.
POST/products
إضافة منتج جديد.
GET/orders
قائمة الطلبات.

استوديو AI

POST/ai/chat
استدعاء AI متعدد المزودين باختيار تلقائي.
GET/ai/usage
إحصائيات استهلاك Tokens اليومية.

مثال طلب

curl -X POST https://app.kwamlemedia.com/api/v1/ai/chat \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Write me an ad for a new product"}
    ],
    "max_tokens": 500
  }'

Webhooks

اشترك في أحداث المنصة الحية (رسالة جديدة، طلب جديد، تعليق جديد):

POST /webhooks
{
  "url": "https://yourdomain.com/webhook",
  "events": ["message.received", "order.created", "comment.posted"]
}

Rate Limiting

  • Free: 60 طلب/دقيقة
  • Pro: 600 طلب/دقيقة
  • Enterprise: 6,000 طلب/دقيقة + custom

الـ headers X-RateLimit-Remaining و X-RateLimit-Reset تُرجع معلومات اللحظة.

SDKs الرسمية قيد التطوير

قريباً: مكتبات لـ Node.js، Python، PHP، Go.
للأسئلة التقنية: api@kwamlemedia.com