编辑用户
更新时间:2025-05-25 05:55:39

编辑用户

请求方法

PUT

请求地址

/open/api/v1/users/{userId}

请求参数

参数 参数类型 数据类型 是否必需 描述
userId Path String 用户主键id,长度32
name Body String 名称,长度小于128
mobile Body String 手机号
mobileCode Body String 手机区号,默认为86
email Body String 邮箱,长度小于128
groupId Body String 分组id,长度32,默认添加至根分组下
mobileCode Body String 手机区号,默认为86
title Body String 职位,长度小于128
gender Body Integer 性别,0:保密;1:男;2:女。默认为保密
password Body String 密码,符合系统 设置的密码安全策略
extension Body String 账号短号,长度小于64

HTTP状态码

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

请求消息示例

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

{
    "name": "zd3",
    "email": "test@yealink.com",
    "mobile": "18100000001",
    "mobileCode": "86",
    "groupId": "1f210c8505504258bbbdc8c6a0574d50",
    "title": "经理",
    "gender": 0,
    "extension": "9999"
}

响应消息示例

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}' 'https://smart.yealink.com/open/api/v1/users/9ecc83e4c7d44728bbb1e2ec226dffe7'
本页目录