وثائق المطور

مرجع API

وثائق API كاملة لبنية كلاودفورت الصوتية. نقاط نهاية REST، بروتوكول WebSocket، وأدلة دمج SDK.

Base URL

https://callem.cloudfort.ir

المصادقة

تتطلب جميع طلبات API المصادقة عبر رمز Bearer في رأس Authorization.

Header

Authorization: Bearer vc_live_YOUR_API_KEY

نقاط النهاية

GET/api/me

احصل على معلومات الحساب المصادق وملخص الاستخدام.

الاستجابة

{
  "account": {
    "id": 1,
    "name": "Your Company",
    "email": "admin@company.com",
    "plan": "pro",
    "status": "active"
  },
  "summary": {
    "total_minutes": 120.5,
    "remaining_minutes": 879.5,
    "current_ccu": 3,
    "max_ccu": 50
  }
}

WS/ws?room={room}&peer={peer}&api_key={key}

نقطة نهاية WebSocket للاتصال الصوتي في الوقت الفعلي. اتصل بمعلمات الاستعلام وأرسل رسائل تحكم JSON.

معلمات الاستعلام

room — Room identifier (use __lobby__ initially)
peer — Unique peer ID
api_key — Your API key

رسائل التحكم

// Join a room
{ "type": "join", "room": "meeting-123" }

// Leave current room
{ "type": "leave" }

// Binary messages are treated as audio data

حدود السرعة والحصص

تختلف حدود الاستخدام حسب الخطة. راقب استخدامك عبر نقطة النهاية /api/me.

Free

5 CCU · 100 min/mo

Starter

25 CCU · 1000 min/mo

Pro

500 CCU · Unlimited

وثائق SDK

SDKs رسمية للمنصات والأطر الشائعة.