嘟哩开放平台
简体中文
繁體中文
English
快速开始 开放接口 嘟哩官网
模板

修改用户信息


请求说明

POST  http://[SERVER:9022]/v1/user/user_update?access_token={access_token}


请求参数

字段

类型

是否必填

说明

access_token

string

Y

认证的token

org_id

string

Y

组织id

account_id

string

Y

账号id

nick_name

string

Y

昵称

phone

string

Y

手机号

mobile_prefix

string

N

国码(如,中国:86)

email

string

N

邮箱

display_in_org

boolean

N

是否展示到通讯录

  • true:是
  • false:否

main_dept

string

N

主部门(多个部门中其中一个)

dept_ids

string[]

N

部门(一个员工可属于多个部门)

post_id

string

N

岗位id

gender

string

N

性别

first_work_date

date

N

首次工作时间 yyyy-MM-dd

join_date

date

N

入职时间 yyyy-MM-dd

regular_date

date

N

转正日期yyyy-MM-dd

probation_date

date

N

试用期到期时间yyyy-MM-dd

请求示例:

json

{
"org_id": "1000000",
"account_id": "200200021",
"nick_name": "xxxxxxx1",
"gender": 1,
"mobile_prefix":"86",
"phone": "",
"email": "1231414324@qq.com",
"display_in_org":true,
"main_dept":"1",
"dept_ids":["1","2"],
"post_id":"1",
"first_work_date":"",
"join_date":"",
"regular_date":"",
"probation_date":""
}


返回结果示例

{
"code": 0,
"msg": "ok",
"data":
{
"org": "companyA",
"org_id":"1000000",
"account_id": "200200021", // 账号ID
"account": "kkk666",
"nick_name": "kingsley",
"status": "1",
"is_online": false,
"mobile_prefix":"86",
"phone": "13610117012",
"email": "13610117012@qq.com",
"gender": 1,
"avatar":"http://...",
"reg_time":"2024-12-12 15:53:07"
}
}

结果字段说明

字段

类型

说明

data


用户列表

org

string

组织名称

org_id

string

组织id

account_id

string

用户id

account

string

用户账号

nick_name

string

昵称

status

int

"1":正常,“2”:禁用,“3”:离职

is_online

boolean

是否在线

  • true:在线
  • false:离线

mobile_prefix

int

手机号码前缀:86

phone

string

手机号码

email

string

邮箱

gender

int

性别,"1":男,“2”:女

avatar

string

用户头像地址

reg_time

date

注册时间 yyyy-MM-dd HH:mm:ss


状态码说明

code

message

说明

100060

Invalid org or account

无效的组织或用户账号

100061

mobile already exist error

手机号已存在

100062

Invalid mobile number

无效的手机号

100063

email already exist error

邮箱已存在

100064

Invalid email

无效的邮箱

100065

Invalid params

参数错误(其他参数不合法)

更多通用错误码