编辑外部联系人

请求方法

PUT

请求地址

/external-contacts/{externalContactId}

请求参数

参数	参数类型	数据类型	是否必需	描述
externalContactId	Path	String	是	外部联系人主键id，长度32
name	Body	String	是	名称，长度小于128
number	Body	String	是	号码，长度小于64
accountType	Body	Integer	是	账号类型；5：SIP；7：H.323；15：RTSP ；16：企业账号；21：Phone号码
groupId	Body	String	是	分组id，长度32
email	Body	String	否	邮箱，长度小于64，若为空则数据更新为空
region	Body	String	否	所属区域，非必填，默认不修改，参数可从“查询节点信息”（/platform/nodes）中获取所有节点的region，如 “cn-shanghai”

HTTP状态码

返回值	描述
200	操作成功
400	客户端传参异常
401	鉴权失败
500	服务端异常

请求消息示例

PUT /open/api/v2/external-contacts/1f0f20618e8b47498f1e010f1be0e7d2 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

{
	"name": "外部4修改",
  	"number": "0004",
  	"accountType": 7,
  	"region": "cn-shanghai"
}

响应消息示例

HTTP/1.1 200
Content-Type: application/json;charset=UTF-8

CURL命令示例

curl -XPUT -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" -d '{"name":"外部4修改","number":"0004","accountType":7,"groupId":"53f0765fadb54fb6b002f3baac2d5ec8"}' 'https://api.yealink.com/open/api/v2/external-contacts/1f0f20618e8b47498f1e010f1be0e7d2'