回拨呼叫取消

最近更新时间:2019-05-23 11:41:38

1. 接口描述

功能: 回拨呼叫取消
接口地址: https://HOST/201511v3/callCancel?id=xxx
请求方式:POST

注意:

上述接口地址的 ID 值测试时由腾讯统一分配。
所有参数类型都是字符串类型(string)。

2. 参数说明

参数名 要求 备注
appId 必选 xxx
callId 必选 回拨请求响应中返回的 callId
cancelFlag 可选 0:不管通话状态直接拆线(默认) 1:主叫响铃以后状态不拆线 2:主叫接听以后状态不拆线 3:被叫响铃以后状态不拆线 4:被叫接听以后状态不拆线

3. 返回结果

参考值 描述
0 成功
-1 版本不支持
-2 参数异常
-3 运营商线路异常
-201 callId 标识的呼叫不存在
-401 appId 非法
-402 URL 不匹配
-403 IP 不在白名单
-423 服务器屏蔽此调用(调用方被入侵或者异常操作)
-501 平台处理请求异常(业务做容灾处理)

4. 示例

输入:

{
    "appId": "65000", 
    "callId": "xxxxxxxxx"
}

输出:

{
    "errorCode": "-201",
    "msg": "callId not exist"
}