创建用户。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/user/create HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体参数。 |
|
| user_id |
string |
是 |
用户 id，最长 64 字符，不能包含字符# |
pdsuserid1 |
| nick_name |
string |
否 |
用户昵称，最长 128 字符 |
pdsuer |
| status |
string |
否 |
用户状态，默认为 enabled
|
enabled |
| role |
string |
否 |
角色，默认为 user
如果当前 domain 支持 subdomain。还可以支持 "subdomain_super_admin", "subdomain_admin”。 枚举值：
|
user |
| avatar |
string |
否 |
头像地址 http 形式时，以 http:// 或 https:// 作为前缀，参数长度最长 4KB data 形式时，以 data://作为前缀，base64 编码，参数长度最长 300KB |
http://a.b.c/pds.jpg |
| phone |
string |
否 |
电话 |
13900001111 |
|
string |
否 |
邮箱地址 |
123@pds.com |
|
| user_data |
object |
否 |
用户自定义数据，最长 1024 字符 |
md |
|
any |
否 |
|||
| group_info_list |
array<object> |
否 |
群组信息 |
|
|
object |
否 |
|||
| group_id |
string |
否 |
群组 id |
g123 |
| user_name |
string |
否 |
用户名，最长 128 字符 |
pdsusername |
| description |
string |
否 |
用户描述，最长 1024 字符 |
VIP用户 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回信息 |
||
| domain_id |
string |
域 id |
bj1 |
| user_id |
string |
用户 id |
dingding_abc001 |
| avatar |
string |
头像地址 |
http://aa.com/1.jpg |
| created_at |
integer |
创建时间，格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒起至现在的毫秒数 |
1639762579768 |
| updated_at |
integer |
修改时间，格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒起至现在的毫秒数 |
1639762579768 |
| nick_name |
string |
昵称 |
001 |
| user_name |
string |
用户名 |
pds |
| phone |
string |
电话 |
13900001111 |
|
string |
邮箱地址 |
a@a.com |
|
| role |
string |
角色
枚举值：
|
admin |
| status |
string |
状态
枚举值：
|
enabled |
| description |
string |
描述 |
vipuser |
| default_drive_id |
string |
缺省空间 id |
1 |
| user_data |
object |
用户自定义数据 |
|
|
any |
自定义项 |
dog |
|
| creator |
string |
创建者 |
user1 |
示例
正常返回示例
JSON格式
{
"domain_id": "bj1",
"user_id": "dingding_abc001",
"avatar": "http://aa.com/1.jpg",
"created_at": 1639762579768,
"updated_at": 1639762579768,
"nick_name": "001",
"user_name": "pds",
"phone": "13900001111",
"email": "a@a.com",
"role": "admin",
"status": "enabled",
"description": "vipuser",
"default_drive_id": "1",
"user_data": {
"key": "dog"
},
"creator": "user1"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。