Skip to main content

update_user 更新用户

POST /api/v1/users/update_user

描述

更新用户接口,用于更新用户信息。

root用户不能被更新。

访问权限

需要登录,具备以下权限:

users:update_user

JSON参数

请求参数如下:

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

说明:

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

请求示例:

{
"username": "huhulala",
"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": "40004",
"errorMessage": "username.not.exist",
"showType": 9
}

错误码

错误码说明错误信息显示类型
40004用户名不存在username.not.exist4
50000服务器配置错误error.server2
40006配置文件加载失败protocol.json.invalid1

9 表示在页面内部展示的错误,如表单验证错误