Skip to main content

add_user 添加新用户

POST /api/v1/users/add_user​

描述​

添加新用户接口，用于添加新用户。

访问权限​

需要登录，具备以下权限：

users:add_user

JSON参数​

请求参数如下：

{
  "username": string,
  "password": string,
  "role": "Root" | "Admin" | "Guest",
  "avatar": string, 
  "introduction": string
}

说明：

  • username: 用户名，必填，长度为5-20个单词字符
  • password: 密码，必填，长度为6-20个字符
  • role: 用户角色，必填，Root|Admin|Guest 之一
  • avatar: 用户头像，必填，图片地址 /images/avatar1.png 到 /images/avatar6.png 之一
  • introduction: 用户简介，必填，不超过200个字符

请求示例：

{
  "username": "huhulala",
  "password": "jiushipassword",
  "role": "Root",
  "avatar": "/images/avatar2.png",
  "introduction": "我是超级管理员"
}

响应结果​

请求返回的HTTP状态码为200

返回结果为JSON格式的数据，您可以通过解析JSON数据来获取API调用的结果信息。结构如下：

{
  "success": true|false,
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}

正确结果示例：

{
  "success": true
}

错误结果示例, 返回false时候需要带上错误码和错误信息：

{
  "success": false,
  "errorCode": "40008",
  "errorMessage": "username.already.exist",
  "showType": 9
}

错误码​

错误码说明错误信息显示类型
40008用户名已经存在username.already.exist1
40009用户名不合法username.illegal1
40010密码不合法password.illegal1
50000服务器错误server.error2
40006配置文件加载失败protocol.json.invalid1