# 修改设备分机

## 接口描述

修改设备分机的基本信息。所有字段均可选，只更新传入的字段。

> 修改分机号、密码、默认呼叫号码或启用状态后，平台会自动把新的 SIP 配置重新下发给设备（火忘下发，失败不影响修改结果；设备配置只推送不拉取，如需立即重推可在设备侧重启或重新保存配置触发注册）。

> 更换所属对讲分组已合并到本接口：传入 `voip_group_id` 参数即可（关联处理规则见请求参数说明）。

## 请求说明
| 接口ID | 协议 | 方法 | PATH |
| --- | --- | --- | --- |
| 106 | HTTPS | PUT | /openapi/v1/voip/devices/:id |

### PATH参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| id | int | 是 | 需要修改的设备分机ID，可通过[遍历设备分机](/voip/遍历设备分机.md)获取 |

### URL参数
| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| accesskey_id | string | 是 | 参见[签名认证](/签名认证.md) |
| expires | int | 是 | 参见[签名认证](/签名认证.md) |
| signature | string | 是 | 参见[签名认证](/签名认证.md) |

### HTTP请求头
| 名称 | 必填 | 说明 |
| --- | --- | --- |
| Content-Type | 是 | `application/json` |

### 请求参数

请求参数以Json格式放置于Body中，如下：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| dial_id | string | 否 | 分机号，5-20 位，只能包含字母、数字及 `_.-` |
| sn | string | 否 | 重新绑定的设备SN，格式为 `xxxxxxxx-xxxxxxxx`（16 位十六进制）或 20 位数字，新设备须已绑定到当前公司且未被封禁 |
| password | string | 否 | 分机密码 |
| display_name | string | 否 | 设备显示名称 |
| remark | string | 否 | 备注 |
| enable | int | 否 | 启用状态（0:启用 / 1:停用）；停用会下发清除配置，使设备主动注销 SIP 注册 |
| default_call_number | string | 否 | 默认呼叫号码，须为**目标分组**内的坐席分机号或呼叫中心号码（含义参见[创建设备分机](/voip/创建设备分机.md)）；传空串表示清除。与 `voip_group_id` 同时修改时按目标分组校验，为空或属于目标分组才允许更换分组 |
| voip_group_id | int | 否 | 更换对讲分组：不传=不变，`0`=默认分组（公司级），正整数=目标分组ID（**不接受 `null`**，公司级一律用 `0`；遍历/创建响应的 `voip_group_id` 已统一输出 `0`，可直接作为本参数回传）。传入值与当前分组一致时无任何变更（幂等）。更换后设备 SIP 配置会自动重新下发（禁用状态的设备保持禁用）；目标分组内分机号/SN 不能与现有冲突 |

> Body 中所有字段均未传入时不做任何修改，直接返回成功。

### 请求示例

```
PUT https://open.vzicloud.com/openapi/v1/voip/devices/101?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json

{
  "display_name": "东门门口机",
  "default_call_number": "90001"
}
```

## 返回说明

成功，则响应的HTTP状态码为200  
失败，则响应的HTTP状态码为非200，具体参考[错误码](/错误码.md)