查询设备信息
该API用于查询OM设备自身的相关信息,如:生产商、硬件版本、软件版本,以及所有的分机、分机组和中继等。
请求示例
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Query">
<DeviceInfo/>
</Control>
参数说明
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
<DeviceInfo> | string | OM设备的基本信息 | 无值 |
响应示例
<?xml version="1.0" encoding="utf-8" ?>
<DeviceInfo>
<manufacturer>New Rock Technologies, Inc</manufacturer>
<model>Rev 6.0.0 OM20-2S/2</model>
<version>Rev 2.1.5.111</version>
<mac>00:0E:A9:00:12:BD </mac>
<devices>
<ext lineid="Phone 1" id="200" />
<ext lineid="IPPhone 50" id="208" />
<line lineid="Line 2" id="02161208234" />
<line lineid="IPLine 21" id="02161204000" />
<group id="1">
<ext id="200" />
</group>
</devices>
</DeviceInfo>
参数说明
说明:<>表示必选项,[]表示可选项(当参数值为默认值或空时,响应消息可能不携带该参数),| 表示或者关系
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
DeviceInfo | object | OM设备信息 | 无 |
<manufacturer> | string | 生产商 | New Rock Technologies, Inc |
<model> | string | 硬件版本 | 如 Rev 6.0.0 OM20-2S/2 |
<version> | string | 软件版本 | 如 Rev 2.1.5.111 |
[mac] | string | 物理地址 | 如 00:0E:A9:00:12:BD(由系统参数API_MAC决定是否携带MAC地址) |
[ext] | object | 分机 | |
<ext lineid> | string | 分机的线路编号,是分机的唯一固定标识 | <Phone | IPPhone> {NO.},如:Phone 1 |
<ext id> | string | 分机号 | |
[line] | object | 中继(外线) | line和trunk是指同一个对象,即中继(外线) |
<line lineid> | string | 中继的线路编号,是中继的唯一固定标识 | <Line | IPLine> { NO.},如:Line 13 |
[line id] | string | 中继号 | |
[group id] | int | 分机组的序号 | 1~50 |
注:
响应结果中包含所有的分机线路和中继线路信息,如果设备线路量很大,注意查询接收的缓存空间;
设备线路量大时,建议使用web查询接口分别获取分机或中继线路。