2.1.7 强拆(Clear)
此类API用于强制挂断OM上的指定通话。该API可强拆的对象包括:分机、来电、去电。
强拆请求的规则说明
- 对于分机,强拆的判断依据是:ext id;
- 对于来去电,强拆的判断依据是:visitor/outer id;
- 双方通话时,不管强拆其中哪一方,该路通话都会被释放。
请求示例
强拆分机:
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Clear">
<ext id="200"/>
</Control>
强拆来电:
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Clear">
<visitor id="2"/>
</Control>
强拆去电:
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Clear">
<outer id="20"/>
</Control>
参数说明
参数名称 | 类型 | 说明 |
---|---|---|
<ext id> | String | 分机号码(可通过查询设备信息获取所有分机号及其对应的线路号) |
<visitor id> | int | 来电的编号,范围:1~4096,从通话开始到结束的时间内是唯一的,但会被循环利用,可作为临时唯一标识。可根据INVITE或INCOMING等事件获取。 |
<outer id> | int | 来电的编号,范围:1~4096,从通话开始到结束的时间内是唯一的,但会被循环利用,可作为临时唯一标识。可根据呼叫过程中的事件获取。 |
响应示例
HTTP/1.0 200 OK
Date: Wed, 22 Feb 2017 08:04:44 GMT
Server:
X-Frame-Options:DENY
Cache-Control:no-cache
Pragma:no-cache
Expires:-1
Access-Control-Allow-Headers: accept, Content-Type
Access-Control-Allow-Origin: (null)
Connection: close
Content-Length: 0
<!--包体为空-->