修改成员信息

• 描述
• 使用须知
• 接口URL
• 请求参数
• 请求示例
• 响应参数
• 响应数据样例

描述

修改成员详细信息，如昵称、备注、职称、归属部门、角色

使用须知

开发前，请仔细阅读开发指南。

• POST请求头

{"Authorization": "Bearer YOUR_APIKEY"}

• YOUR_APIKEY请阅读开发指南了解。

接口URL

POST - /openapi/v1/user/update

请求参数

参数名	示例值	参数类型	是否必填	参数描述
user_id	5043f034699af3458734f91c	String	是	成员id
name	李四	String	否	名称
remark	12月2日加入	String	否	备注
uniqueid	12567	String	否	企业内用户ID
departments	[5f0d7cf9f4361283774fcac4]	Array	否	要修改的部门id
main_department	5f0d7cf9f4361283774fcac4	String	否	主部门id
job_title		Array	否	要修改的职称信息
job_title.dept_id	51d1177b964603db9e60a962	String	否	部门id
job_title.job_title	组长	String	否	职称
roles	[]	Array	否	要修改的角色id

请求示例

{
    "user_id": "5c06e86f11f87c94fb1c24ee",
    "name": "李四",
    "remark": "12月2日加入",
    "uniqueid":"12567",
    "departments": [
        "5f0d7cf9f4361283774fcac4"
    ],
    "main_department": "50daae9fb060f5c502307cb3",
    "job_title": [
        {
            "dept_id": "51d1177b964603db9e60a962",
            "job_title": "组长"
        }
    ],
    "roles": [
        "5ee8f9e0706af569e58b1cfa",
        "525fb26fdcb1d02adda3dc6d"
    ]
}

响应参数

参数名	示例值	参数类型	参数描述
user	-	Object
user.user_id	5043f034699af3458734f91c	String	成员id
user.name	测试	String	名称
user.account	user_wlsbap89940	String	账号
user.country_code	86	String	手机区号
user.mobile	18911111112	String	手机号
user.email	123456@qq.com	String	邮箱
user.category	2	String	成员状态（-1表示被邀请的人尚未同意其邀请，同意后自动变为2，0表示团队创建者，2表示普通成员，-2离职成员）
user.mobilestatus	1	String	手机验证状态, 0(未验证) 1(已验证)
user.emailstatus	1	String	邮箱验证状态, 0(未验证) 1(已验证)
user.uniqueid	CeShi	String	企业内用户ID
user.remark	-	String	成员的备注信息
user.title	-	String	成员的职称（旧职称字段已废弃）
user.departments	51d1177b964603db9e60a962	Array	所属部门id
user.main_department	51d1177b964603db9e60a962	String	主部门id
user.job_title	-	Array	职称信息
user.job_title.dept_id	51d1177b964603db9e60a962	String	部门id
user.job_title.job_title	组长	String	职称
user.roles	[]	Array	所属角色组id

响应数据样例

{
    "user": {
        "user_id": "5043f034699af3458734f91c",
        "name": "李四",
        "account": "user_wlsbap89940",
        "country_code": "86",
        "mobile": "18911111112",
        "email": "123456@qq.com",
        "category": "2",
        "mobilestatus": "1",
        "emailstatus": "1",
        "uniqueid": "CeShi",
        "remark": "12月2日加入",
        "title": "主管",
        "departments": [
            "5f0d7cf9f4361283774fcac4"
        ],
        "main_department": "5f0d7cf9f4361283774fcac4",
        "job_title": [
            {
                "dept_id": "51d1177b964603db9e60a962",
                "job_title": "组长"
            }
        ],
        "roles": [
            "525fb26fdcb1d02adda3dc6d",
            "5ee8f9e0706af569e58b1cfa"
        ]
    }
}