مستندات توسعه‌دهنده

مرجع API

مستندات کامل API برای زیرساخت صوتی کلودفورت. نقاط پایانی REST، پروتکل WebSocket و راهنمای ادغام SDK.

Base URL

https://callem.cloudfort.ir

احراز هویت

همه درخواست‌های API نیاز به احراز هویت از طریق Bearer token در هدر 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 برای ارتباط صوتی بلادرنگ. با پارامترهای query متصل شوید و پیام‌های کنترلی JSON ارسال کنید.

پارامترهای Query

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

SDKهای رسمی برای پلتفرم‌ها و فریم‌ورک‌های محبوب.