通话 Token

接口说明

通话进行中，当 RTC 接入令牌即将过期时，调用本接口获取新令牌以保持通话连接。RTC 接入令牌在 data.expire_at 之后失效，客户端应在到期前提前续期。

请求信息

项目	内容
Method	POST
URL	/api/calls/{callId}/token/renew
鉴权	是，Bearer Token

请求参数

参数名	类型	必填	说明
callId	int	是	路径参数，通话 ID
terminal_id	string	是	终端标识，最长 64 字符

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/calls/5001/token/renew" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"terminal_id": "client-android-abc123"}'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	提示信息
data.rtc_token	string	新的 RTC 接入令牌
data.expire_at	string|null	令牌过期时间（ISO 8601），可为空

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "rtc_token": "xxxxxxxxxxxxxxxxxxxxxx",
    "expire_at": "2026-07-05T13:00:00Z"
  }
}

失败响应

{ "code": 41001, "message": "通话不存在", "data": null }

{ "code": 41009, "message": "令牌续期失败", "data": null }