更新用户
调用该接口更新企业用户信息。
请求
| 基本 | |
|---|---|
| 请求方式 | PATCH |
| 请求地址 | /openapi/v3/contacts/users/:union_id |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | 值格式:Bearer {{access_token}}调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,不同类型的访问凭证可获取的数据范围不同,参考 获取访问凭证 。 支持鉴权类型: • 应用级token:以应用身份调用 API,校验应用的数据访问范围。参考 获取企业内部应用access_token。• 用户级token:以登录用户身份调用 API,校验用户的可见数据范围。参考 获取登录用户access_token。 |
| Content-Type | string | 是 | 固定值:application/json; charset=utf-8 |
路径参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| union_id | string | 是 | 用户ID |
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 姓名,1-64字符 |
| department_ids | array[string] | 否 | 如果为空,则保持原状 |
| mobile | string | 否 | 手机号(合法手机号校验),mobile、email、username 不能同时为空 |
| string | 否 | 邮箱(合法邮箱校验),mobile、email、username 不能同时为空 | |
| employee_number | string | 否 | 工号,不超过64字符 |
| position | string | 否 | 职位,不超过100字符 |
| join_time | string | 否 | 入职时间,格式:2006-01-02 |
| username | string | 否 | SSO登录名,mobile、email、username 不能同时为空,不超过64字符 |
请求体示例
1{2 "name": "zyxtest",3 "mobile": "+86 15012453582",4 "email": "xx@qq.com",5 "department_ids": [6 "923168858645200896"7 ],8 "employee_number": "458152",9 "position": "架构师",10 "join_time": "2023-09-01",11 "username": "zyxtest"12}
响应
响应体
1{2 "code": 0,3 "msg": "success"4}
