创建用户
一、接口URL
/umsopenapi/official/user/create
二、功能
创建用户(*注: 07:00-23:59时段同步阀值10000次/天,超出返回错误;00:00-06:59时段不做阀值限制)
三、请求参数
http header 请求参数
| 名称 | 类型 | 是否必传 | 传参方式 | 说明 |
|---|---|---|---|---|
| token | String | true | http header | 调用全时API的身份验证token |
http body 请求参数
| 名称 | 类型 | 是否必传 | 传参方式 | 说明 |
|---|---|---|---|---|
| name | String | true | RequestBody | 姓名。 |
| organizationId | Long | true | RequestBody | 组织id，必填。 |
| loginName | String | false | RequestBody | 用户账号名, 选填； 账号名，手机号和邮箱必须三选一必填 |
| String | false | RequestBody | 用户邮箱, 选填； 账号名，手机号和邮箱必须三选一必填 | |
| mobile | String | false | RequestBody | 手机号， 选填。账号名，手机号和邮箱必须三选一必填 |
| countryCode | String | false | RequestBody | 国家码， 选填。默认（86） |
| password | String | false | 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"}] |
四、请求体
{
”loginName":"b54d2e28edf898ff08ae55a85ccfce9f"
"email": "test@quanshi.com",
"mobile": "13912345678",
"name": "王小明",
"position": "软件工程师",
"office": "苏州",
"organizationId": 73879129
}
五、返回参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 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": "苏州"，
"organizationId": 73879129
},
"message": "success",
"requestId": "openapi-ums-165-17e9061a-adc5-4392-b160-0305fb65a0f5"
}
