# 会控回调webSocket接口
步骤一:先获取token
步骤二:连接ws服务器
# 1 步骤一:获取token
注意:需要进行签名认证
接口地址 | 方法 | 说明 |
---|---|---|
BaseUrl/api/v1/getToken | GET | 获取token |
响应状态码:
参数 | 描述 |
---|---|
200 | 成功 |
400 | 失败,参数错误或请求地址不存在 |
401 | 未授权,未经授权的(App ID/Customer Certificate 匹配错误)。 |
500 | 系统内部错误 |
10400 | accessKey验证不通过 |
响应数据:
实例:
[GET] https://192.168.2.251/client/api/v1/getToken
响应:
{
"code": 200,
"msg": "e0dbf19c4db191e0db19c41"
}
# 2 步骤二、连接ws服务器
# 1、注意事项:
1、不需要进行签名认证,不需要设置header 2、在第一步获取token,10分钟之内没有进行ws服务器连接操作,需要重新获取token。连接之后,token一直维持到WebSocket断开。 3、websocket超时时间为10分钟,需要发送心跳包,维持连接,客户端发送ping包,服务器返回pong包,pong包等类型的信息可不用处理。
# 2、出现以下情况会建立链接失败:
同一个appId连接数已达上限100 token验证失败 token超时,请重新获取token 参数appId、token必填
接口地址 | 说明 |
---|---|
wss://192.168.2.251/paasws?appId={appId}&token={token} | 连接ws服务器 |
Parameters:
参数 | 长度 | 描述 |
---|---|---|
appId | 32位字符串 | 控制台中项目的APP ID(应用标识ID) |
token | 32位字符串 | 步骤一获取的token |
响应状态码:
参数 | 描述 |
---|---|
200 | 成功 |
400 | 失败,参数错误或请求地址不存在 |
401 | 未授权,未经授权的(App ID/Customer Certificate 匹配错误)。 |
500 | 系统内部错误 |
响应数据:
实例:
wss://192.168.2.251/paasws?appId={appId}&token={token}
响应:
见媒体服务器数据格式定义文档
← SIP呼叫