查询中继
该API用于查询指定中继(又称为外线)的相关信息,如:配置参数、线路状态、呼叫状态等。
请求示例
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Query">
<trunk id="2174"/>
</Control>
参数说明
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
<trunk id> | string | 中继号码(外线号码) | 必须为OM上的有效中继,值不能为空 |
响应示例
<?xml version="1.0" encoding="utf-8" ?>
<Status>
<trunk id="2174">
<lineid>Line 75</lineid>
<state>active</state>
<visitor id="2" from="202" to="2174" callid="36866">
<state>talk</state>
</visitor>
</trunk>
</Status>
参数说明
说明:<>表示必选项,[]表示可选项(当参数值为默认值或空时,响应消息可能不携带该参数),| 表示或者关系
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
<trunk id> | string | 中继(外线)号 | 数字字符串 |
<lineid> | string | 中继的线路编号,是中继的唯一固定标识 | IPLine | Line XXX |
<state> | string | 中继的线路状态 | ready: 可用 active: 摘机、振铃或通话中 unwired:未接线 offline:离线 注:对于IP中继多路并发时,只要有一路空闲可用,其状态就是ready。 |
[outer] | object | 去电 | |
<id> | int | 去电的编号,可通过该参数对去电进行转接、查询、挂断等操作 | |
<from> | string | 原始主叫号码 | |
<to> | string | 原始被叫号码(对于visitor而言,原始被叫为来电呼入中继号码) | |
<trunk> | string | 中继号,该去电通过该中继呼出 | |
<callid> | int | 通话的相对唯一符 | |
<state> | string | 通话状态 | Talk: 通话进行中 Progress: 呼叫处理过程中 Wait: 呼叫等待中 |
[visitor] | object | 来电 | |
<id> | int | 来电的编号,可通过该参数对来电进行转接、查询、挂断等操作 | |
<from> | string | 原始主叫号码 | |
<to> | string | 原始被叫号码(对于visitor而言,原始被叫为来电呼入的中继号码) | |
<callid> | int | 该路通话的相对唯一的编号 | |
<state> | string | 通话状态 | Talk: 通话进行中 Progress: 呼叫处理过程中 Wait: 呼叫等待中 |