批量编辑 IP 话机

批量编辑使用相同模板的同型号 IP 话机的分机分配设置。

请求 URL

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

请求参数

参数 是否必填 类型 说明
batch_id_list 是 Array<Integer> IP 话机的唯一 ID。
注：
phone_list 是 Array<Ext_Assign> 话机的分机分配设置。
Ext_Assign
参数 是否必填 类型 说明
id 是 Integer IP 话机的唯一 ID。
注： 可使用 搜索特定 IP 话机 接口查询话机 ID。
mac 是 String IP 话机的 MAC 地址。
注： 可使用 搜索特定 IP 话机 接口查询话机 MAC 地址。
ext_id 是 Integer 要分配给 IP 话机的分机的唯一 ID。
注： 可使用 搜索特定分机 接口查询分机的 ID。

响应参数

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

示例

请求示例

更新两台 IP 话机 (ID 为 75 和 90) 的分机分配设置。

POST /openapi/v1.0/phone/batchupdate?access_token=fy59UJHFHJvOMthVlQM4z9sq6gFHcZVn HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json
User-Agent: OpenAPI

{
	"batch_id_list": [75, 90],
       "phone_list": [{
		"id": 75,
		"mac": "10:00:00:00:00:00",
		"ext_id": 7
	}, 
      {
		"id": 90,
		"mac": "11:11:11:11:11:11",
		"ext_id": 8
	}]
	
}

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
}