更新回调配置

最近更新时间:2024-10-29 16:09:12

我的收藏

功能说明

管理员可通过该接口更新回调。

接口说明

请求 URL 示列

https://xxxxxx/v1/callback/update?sdkappid=88888888&identifier=administrator&usersig=xxx&random=99999999&contenttype=json

请求参数说明

下表仅列出调用本接口时涉及修改的参数及其说明,更多参数详情请参考 REST API 简介
参数
说明
xxxxxx
SDKAppID 所在国家/地区对应的专属域名:
中国:callkit.trtc.tencent-cloud.com
v1/callback/update
请求接口
sdkappid
创建应用时控制台分配的 sdkappid
identifier
必须为 IM App 管理员账号
usersig
App 管理员账号生成的签名,具体操作请参见 生成 UserSig
random
请输入随机的32位无符号整数,取值范围0 - 4294967295
contenttype
请求格式固定值为json

最高调用频率

10次/秒。

请求包示例

{
"address": "https://www.example2.com/callback",
"actions": [
"call_busy",
"cancel",
"normal_end"
]
}

请求字段说明

字段
类型
属性
说明
address
String
必填
回调的地址,需要以 http/https 开头,建议使用更为安全的 https
actions
Array
必填
需要触发回调的情景,列表请参考 回调命令字列表

应答包体示例

{
"errorCode": 0,
"errorMessage": "Success",
"requestId": "5b0fa500064397cad3554506e27e18e1",
"data": "https://www.example2.com/callback"
}

应答包字段说明

字段
类型
说明
errorCode
Integer
错误码,0为成功
errorMessage
String
错误信息
requestId
String
请求的唯一 ID
data
String
更新成功的回调地址

错误码说明

错误码
含义说明
0
请求成功
50001
当前应用需要购买 TUICallKit 群组通话版套餐包方可使用
999
没有配置信息