开发者文档

API 参考

Cloudfort 语音基础设施的完整 API 文档。REST 端点、WebSocket 协议和 SDK 集成指南。

Base URL

https://callem.cloudfort.ir

身份验证

所有 API 请求都需要在 Authorization 标头中使用 Bearer 令牌进行身份验证。

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 文档

适用于流行平台和框架的官方 SDK。