编辑用户

请求方法

PUT

请求地址

/users/{userId}

请求参数

参数	参数类型	数据类型	是否必需	描述
userId	Path	String	是	用户主键id，长度32
name	Body	String	是	名称，长度小于128
extension	Body	String	是	分机号，必须符合企业号码段规则，默认4位数字
mobileCode	Body	String	是	手机区号
mobile	Body	String	是	手机号
groupId	Body	String	是	分组id
gender	Body	Integer	是	性别，0：保密；1：男；2：女
email	Body	String	否	邮箱，若为空则数据更新为空
title	Body	String	否	职位，长度小于128，若为空则数据更新为空
enableMeetNow	Body	Boolean	否	是否启用即时会议功能
enableScheduled	Body	Boolean	否	是否启用会议预约功能
~~visiblePermission~~	Body	VisiblePermission	否	可见权限请求参数，默认可见企业内全部联系人(A)，字段废弃

HTTP状态码

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

VisiblePermission

参数	数据类型	是否必须	描述
code	String	是	可见权限类型，详见可见权限类型
nodes	VisiblePermissionNode[]	否	节点数据，code为E时必填

VisiblePermissionNode

参数	数据类型	是否必须	描述
dataId	String	是	节点数据id，E权限时有效，其值为节点数据类型对应的实体id
dataType	Integer	否	节点数据类型，E权限时有效，详见节点数据类型

可见权限类型

可见权限类型	值
可见企业内全部联系人	A
可见所在部门及同级部门的所有联系人	B
仅可见所在部门的所有联系人	C
仅可见自己	D
自定义	E

节点数据类型

节点数据类型	值
用户分组	1
用户	2
设备分组	3
设备	4
VMR分组	5
VMR	6
外部联系人分组	9
外部联系人	10

请求消息示例

PUT /v2/users/9ecc83e4c7d44728bbb1e2ec226dffe7 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

{
	"name":"zd2",
  	"extension":"3333",
  	"mobile":"17700000000",
  	"enableMeetNow": true,
  	"enableScheduled": true
}

响应消息示例

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":"zd2","extension":"3333","mobileCode":"zd2","mobile":"17700000000","groupId":"53f0765fadb54fb6b002f3baac2d5ec8","gender":0,"enableMeetNow":true,"enableScheduled": true}' 'https://api.yealink.com/v2/users/9ecc83e4c7d44728bbb1e2ec226dffe7'