Skip to main content

save_avatar

POST /api/v1/users/save_avatar​

描述​

保存用户头像接口，用于保存用户的头像。

访问权限​

需要登录，只能保存自己的头像。

具备以下权限：

users:save_avatar

JSON参数​

请求参数如下：

{
  "username": string,
  "avatar": string
}
tip
  • username: 用户名，必填，长度为5-20个单词字符
  • avatar: 用户头像，必填，图片地址 /images/avatar1.png 到 /images/avatar6.png 之一

请求示例：

{
  "username": "huhulala",
  "avatar": "/images/avatar2.png"
}

响应结果​

请求返回的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": "avatar.not.exist",
  "errorMessage": "用户头像不存在",
  "showType": 4
}

错误码​

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

4 表示错误, 弹出错误提示框