批量添加 IP 话机
添加多台相同供应商和型号的 IP 话机到自动配置列表。
请求 URL
POST {base_url}/{api_path}/phone/batchcreate?access_token={access_token}
请求参数
参数 | 是否必填 | 类型 | 说明 |
---|---|---|---|
vendor | 是 | String | 话机供应商。 注: 可使用 查询自动配置的配置选项 接口查询可用选项。 |
model | 是 | String | 话机型号。 注: 可使用 查询自动配置的配置选项 接口查询可用选项。
|
phone_list | 是 | Array<Ext_Assign> | IP 话机的分机分配信息。 |
template_name | 是 | String | 要应用到 IP 话机的配置模板的名称。 注: 可使用 查询自动配置的配置选项 接口查询可用选项。
|
provisioning_method | 是 | String | IP 话机的自动配置方式。 取值范围:
|
enb_rps_auth | 否 | Integer |
是否启用 “第一次自动配置时要求验证” 选项。 取值范围:
|
- Ext_Assign
-
表 2. 参数 是否必填 类型 说明 mac 是 String IP 话机的 MAC 地址。 注: 可使用 搜索特定 IP 话机 接口查询话机 MAC 地址。ext_id 是 Integer 要分配给 IP 话机的分机的唯一 ID。 注: 可使用 搜索特定分机 接口查询分机的 ID。
响应参数
参数 | 类型 | 说明 |
---|---|---|
errcode | Integer | 返回错误码。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息。
|
errmsg | String | 返回信息。
|
示例
请求示例
POST /openapi/v1.0/phone/batchcreate?access_token=fy59UJHFHJvOMthVlQM4z9sq6gFHcZVn HTTP/1.1
Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json
User-Agent: OpenAPI
{
"vendor": "Yealink",
"model": "SIP-T53W",
"template_name": "YSDP_YealinkT5",
"provisioning_method": "rps",
"enb_rps_auth": 1,
"phone_list": [
{
"mac": "10:00:00:00:00:00",
"ext_id": 3
},
{
"mac": "11:11:11:11:11:11",
"ext_id": 4
}]
}
响应示例
HTTP/1.1 200 OK
{
"errcode": 0,
"errmsg": "SUCCESS",
}