批量添加 IP 话机

添加多台相同供应商和型号的 IP 话机到自动配置列表。

请求 URL

POST {base_url}/{api_path}/phone/batchcreate?access_token={access_token}

请求参数

表 1.
参数 是否必填 类型 说明
vendor 是 String 话机供应商。
注： 可使用 查询自动配置的配置选项 接口查询可用选项。
model 是 String 话机型号。
注： 可使用 查询自动配置的配置选项 接口查询可用选项。
phone_list 是 Array<Ext_Assign> IP 话机的分机分配信息。
template_name 是 String 要应用到 IP 话机的配置模板的名称。
注： 可使用 查询自动配置的配置选项 接口查询可用选项。
provisioning_method 是 String IP 话机的自动配置方式。

取值范围：rps
enb_rps_auth 否 Integer

是否启用 “第一次自动配置时要求验证” 选项。

取值范围：
  • 0：禁用 (默认)
  • 1：启用
Ext_Assign
表 2.
参数 是否必填 类型 说明
mac 是 String IP 话机的 MAC 地址。
注： 可使用 搜索特定 IP 话机 接口查询话机 MAC 地址。
ext_id 是 Integer 要分配给 IP 话机的分机的唯一 ID。
注： 可使用 搜索特定分机 接口查询分机的 ID。

响应参数

表 3.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。

示例

请求示例

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",
}