# 遍历设备分机

## 接口描述

按照一定条件遍历当前账号（AccessKey 所属公司）的设备分机列表。

设备分机是绑定臻识设备的分机（建议分机号直接使用设备 SN），设备用它注册到平台和呼叫坐席。列表按公司维度返回，包含公司级（默认分组）与各对讲分组下的设备分机；可通过 `wheres` 的 `voip_group_id` 筛选指定对讲分组下的设备分机（`0` 筛选公司级默认分组）。

分机密码不会在任何接口中返回。

## 请求说明
| 接口ID | 协议 | 方法 | PATH |
| --- | --- | --- | --- |
| 104 | HTTPS | GET | /openapi/v1/voip/devices |

### PATH参数

无

### URL参数
| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| page | int | 否 | 页码，默认 1 |
| size | int | 否 | 每页条数，默认 10000 |
| wheres | string | 否 | 参见[WHERES参数](/WHERES参数.md) |
| accesskey_id | string | 是 | 参见[签名认证](/签名认证.md) |
| expires | int | 是 | 参见[签名认证](/签名认证.md) |
| signature | string | 是 | 参见[签名认证](/签名认证.md) |

*wheres允许填入的k：*

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | int | 设备分机ID |
| enable | int | 启用状态（0:启用 / 1:停用） |
| dial_id | string | 分机号 |
| sn | string | 设备SN |
| display_name | string | 设备显示名称 |
| status | int | SIP 注册状态（0:在线 / 1:离线） |
| voip_group_id | int | 所属对讲分组ID |

### 请求示例

```
GET https://open.vzicloud.com/openapi/v1/voip/devices?page=1&size=10&accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
```

## 返回说明


### 返回参数
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| page | int | 当前页码 |
| size | int | 当前分页大小 |
| total | int | 符合条件的设备分机总数 |
| items | array | 设备分机列表 |
| items[].id | int | 设备分机ID |
| items[].sn | string | 设备SN |
| items[].dial_id | string | 分机号 |
| items[].display_name | string | 设备显示名称 |
| items[].enable | int | 启用状态（0:启用 / 1:停用） |
| items[].status | int | SIP 注册状态（0:在线 / 1:离线） |
| items[].default_call_number | string | 默认呼叫号码（未配置时为空串），含义参见[创建设备分机](/voip/创建设备分机.md) |
| items[].domain | string | SIP 域名（公司级如 `2.voip1.sip`，分组级如 `2.xiaoqu-a.voip1.sip`） |
| items[].voip_group_id | int | 所属对讲分组ID；`0` = 公司级默认分组（与修改接口的 `voip_group_id` 取值一致） |
| items[].voip_group_name | string | 所属对讲分组名称；公司级默认分组时为 `-` |

**注：返回参数里可能还包含其他信息但未在上面的表格内列出，请勿使用！**

### 返回示例


```json
{
  "page": 1,
  "size": 10,
  "total": 2,
  "items": [
    {
      "id": 101,
      "sn": "5c88cc28-eeee7a12",
      "dial_id": "5c88cc28-eeee7a12",
      "display_name": "门口机-1",
      "enable": 0,
      "status": 0,
      "default_call_number": "80001",
      "domain": "2.xiaoqu-a.voip1.sip",
      "voip_group_id": 12,
      "voip_group_name": "小区A"
    },
    {
      "id": 102,
      "sn": "34020000-02020001",
      "dial_id": "34020000-02020001",
      "display_name": "门口机-2",
      "enable": 0,
      "status": 1,
      "default_call_number": "",
      "domain": "2.voip1.sip",
      "voip_group_name": "-"
    }
  ]
}
```