用户资料修改

  • 权限说明： user.edit 修改 status 状态权限为 user.edit.status
  • 接口说明： 用户资料修改
  • 接口地址： /api/users/{id}
  • 请求方式： PATCH

请求参数

参数名称类型是否必须描述
passwordstring否原密码，只有自己修改才需要传原密码，管理有权限的用户组不需要此参数;小程序注册的用户初始化密码时不需要传此参数
newPasswordstring否新密码
password_confirmationstring否新密码确认密码
payPasswordstring否支付密码，只有自己首次初始化支付密码可以不传 pay_password_token
pay_password_confirmationstring否支付密码确认密码
pay_password_tokenstring否修改支付密码需要通过获取验证 token接口获取
mobilestring否手机号
statusint否用户状态 0 正常 1 禁用 2 审核中 3 审核拒绝 4 审核忽略
refuse_messagestring否审核拒绝原因
signaturestring否用户签名
usernamestring否用户名
register_reasonstring否注册原因

请求示例

  1. {
  2.   "data": {
  3.     "attributes": {
  4.       "newPassword": "newPassword",
  5.       "mobile": "mobile",
  6.       "status": 1
  7.     }
  8.   }
  9. }

status 修改时 触发通知表

原值修改值触发指定通知 ID通知名称 
0 正常1 禁用10账号禁用通知
1 禁用0 正常11账号解除禁用通知
2 审核中0 正常2审核通过通知
2 审核中3 审核拒绝3审核拒绝通知
2 审核中4 审核忽略无不发送通知

返回说明

  • 成功， http 状态码： 200
  • 失败， http 状态码： 非 200

返回结果

参数名称类型出现要求描述
dataobject基础数据
typestring数据类型
idint数据 id
attributesobject数据属性
idint用户 id
usernamestring用户名
mobilestring手机号（脱敏）
avatarUrlstring头像地址
threadCountint主题数
followCountint关注数
fansCountint粉丝数
followobject关注状态 0：未关注 1：已关注 2：互相关注
statusint状态
signaturestring签名
loginAtdatetime登录时间
joinedAtdatetime加入时间
expiredAtdatetime到期时间
createdAtdatetime创建时间
updatedAtdatetime修改时间
canEditbool是否可以编辑
canDeletebool是否可以删除
canWalletPaybool是否可以使用钱包支付
registerReasonstring注册理由
banReasonstring禁用理由
originalMobilestring完整手机号
registerIpstring注册 ip
lastLoginIpstring最后登录 ip
identitystring注册理由
realnamestring实际姓名
walletBalancefloat当前用户用户余额
paidbool是否是付费用户
payTimedatetime支付时间
unreadNotificationsint未读消息数
typeUnreadNotificationsarray未读消息数明细
typeUnreadNotifications.repliedarray未读回复消息数
typeUnreadNotifications.likedarray未读点赞消息数
typeUnreadNotifications.rewardedarray未读打赏消息数
typeUnreadNotifications.systemarray未读系统消息数
usernameBoutint当前用户用户名修改了几次
canEditUsernamebool当前用户是否可以修改用户名

返回示例

  1. {
  2.   "data": {
  3.     "type": "users",
  4.     "id": "1",
  5.     "attributes": {
  6.       "id": 1,
  7.       "username": "username",
  8.       "mobile": "mobile",
  9.       "avatarUrl": "",
  10.       "threadCount": 30,
  11.       "followCount": 0,
  12.       "fansCount": 0,
  13.       "follow": null,
  14.       "status": 0,
  15.       "signature": "这是签名",
  16.       "loginAt": "2020-02-13T11:42:27+08:00",
  17.       "joinedAt": "2019-12-16T19:41:17+08:00",
  18.       "expiredAt": "2020-02-19T18:26:52+08:00",
  19.       "createdAt": "2019-12-16T19:41:17+08:00",
  20.       "updatedAt": "2020-02-13T15:45:15+08:00",
  21.       "canEdit": true,
  22.       "canDelete": true,
  23.       "canWalletPay": true,
  24.       "registerReason": "",
  25.       "banReason": "",
  26.       "originalMobile": "mobile",
  27.       "registerIp": "192.168.10.1",
  28.       "lastLoginIp": "192.168.10.1",
  29.       "identity": "",
  30.       "realname": "",
  31.       "paid": null,
  32.       "payTime": null,
  33.       "unreadNotifications": 8,
  34.       "usernameBout": 0,
  35.       "typeUnreadNotifications": {
  36.         "replied": 8
  37.       }
  38.     }
  39.   }
  40. }