更新用户

一、接口URL

/umsopenapi/official/user/update

二、功能

更新用户(*注: 07:00-23:59时段同步阀值10000次/天,超出返回错误;00:00-06:59时段不做阀值限制)

三、请求参数

http header 请求参数

名称 类型 是否必传 传参方式 说明
token String true http header 调用全时API的身份验证token
名称 类型 是否必传 传参方式 说明
userId Long true RequestBody 用户Id
email String false RequestBody 用户邮箱, 选填; 手机号和邮箱必须二选一必填
mobile String false RequestBody 手机号, 选填。手机号和邮箱必须二选一必填
countryCode String false RequestBody 国家码, 选填。默认(86)
password String false RequestBody 用户登陆密码,非必填
name String true RequestBody 姓名。
position String false RequestBody 职务,选填。
office String false RequestBody 办公地点, 选填。
externalUserName String false RequestBody 第三方用户id, 选填。
buyFeePropss Array false RequestBody 购买或者取消账号付费项目,包含字段buyPropss(销售端 salesEnd)、type(create开通/delete取消),如:[{"buyPropss":"salesEnd","type":"create"},{"buyPropss":"clipTools","type":"create"}]

四、请求体

{
    "userId":12421243,
    "email": "test@quanshi.com",
    "mobile": "13912345678",
    "name": "王小明",
    "position": "软件工程师",
    "office": "苏州"
}

五、返回参数

名称 类型 说明
code Integer 结果码,0: 成功, 非0:失败 (具体描述见错误码表)
data json 返回数据
message String 错误描述
requestId String 请求唯一ID。查询接口日志时需要,建议打印日志

六、返回体

{
    "code": 0,
    "data":{
        "userId":12421243,
        "email": "test@quanshi.com",
        "mobile": "13912345678",
        "name": "王小明",
        "position": "软件工程师",
        "office": "苏州"
    },
    "message": "success",
    "requestId": "openapi-ums-165-17e9061a-adc5-4392-b160-0305fb65a0f5"
}