# 用户资料修改
- 权限说明: user.edit 修改 status 状态权限为 user.edit.status
- 接口说明: 用户资料修改
- 接口地址: /api/users/{id}
- 请求方式: PATCH
# 请求参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| password | string | 否 | 原密码,只有自己修改才需要传原密码,管理有权限的用户组不需要此参数;小程序注册的用户初始化密码时不需要传此参数 |
| newPassword | string | 否 | 新密码 |
| password_confirmation | string | 否 | 新密码确认密码 |
| payPassword | string | 否 | 支付密码,只有自己首次初始化支付密码可以不传 pay_password_token |
| pay_password_confirmation | string | 否 | 支付密码确认密码 |
| pay_password_token | string | 否 | 修改支付密码需要通过[获取验证 token](ResetPayPassword.html)接口获取 |
| mobile | string | 否 | 手机号 |
| status | int | 否 | 用户状态 0 正常 1 禁用 2 审核中 3 审核拒绝 4 审核忽略 |
| refuse_message | string | 否 | 审核拒绝原因 |
| signature | string | 否 | 用户签名 |
| username | string | 否 | 用户名 |
| register_reason | string | 否 | 注册原因 |
# 请求示例
{
"data": {
"attributes": {
"newPassword": "newPassword",
"mobile": "mobile",
"status": 1
}
}
}
# status 修改时 触发通知表
| 原值 | 修改值 | 触发指定通知 ID | 通知名称 |
|---|---|---|---|
| 0 正常 | 1 禁用 | 10 | 账号禁用通知 |
| 1 禁用 | 0 正常 | 11 | 账号解除禁用通知 |
| 2 审核中 | 0 正常 | 2 | 审核通过通知 |
| 2 审核中 | 3 审核拒绝 | 3 | 审核拒绝通知 |
| 2 审核中 | 4 审核忽略 | 无 | 不发送通知 |
# 返回说明
- 成功, http 状态码: 200
- 失败, http 状态码: 非 200
# 返回结果
| 参数名称 | 类型 | 出现要求 | 描述 |
|---|---|---|---|
| **data** | object | 基础数据 | |
| type | string | 数据类型 | |
| id | int | 数据 id | |
| **attributes** | object | 数据属性 | |
| id | int | 用户 id | |
| username | string | 用户名 | |
| mobile | string | 手机号(脱敏) | |
| avatarUrl | string | 头像地址 | |
| threadCount | int | 主题数 | |
| followCount | int | 关注数 | |
| fansCount | int | 粉丝数 | |
| follow | object | 关注状态 0:未关注 1:已关注 2:互相关注 | |
| status | int | 状态 | |
| signature | string | 签名 | |
| loginAt | datetime | 登录时间 | |
| joinedAt | datetime | 加入时间 | |
| expiredAt | datetime | 到期时间 | |
| createdAt | datetime | 创建时间 | |
| updatedAt | datetime | 修改时间 | |
| canEdit | bool | 是否可以编辑 | |
| canDelete | bool | 是否可以删除 | |
| canWalletPay | bool | 是否可以使用钱包支付 | |
| registerReason | string | 注册理由 | |
| banReason | string | 禁用理由 | |
| originalMobile | string | 完整手机号 | |
| registerIp | string | 注册 ip | |
| lastLoginIp | string | 最后登录 ip | |
| identity | string | 注册理由 | |
| realname | string | 实际姓名 | |
| walletBalance | float | 当前用户 | 用户余额 |
| paid | bool | 是否是付费用户 | |
| payTime | datetime | 支付时间 | |
| unreadNotifications | int | 未读消息数 | |
| typeUnreadNotifications | array | 未读消息数明细 | |
| typeUnreadNotifications.replied | array | 未读回复消息数 | |
| typeUnreadNotifications.liked | array | 未读点赞消息数 | |
| typeUnreadNotifications.rewarded | array | 未读打赏消息数 | |
| typeUnreadNotifications.system | array | 未读系统消息数 | |
| usernameBout | int | 当前用户 | 用户名修改了几次 |
| canEditUsername | bool | 当前用户 | 是否可以修改用户名 |
# 返回示例
{
"data": {
"type": "users",
"id": "1",
"attributes": {
"id": 1,
"username": "username",
"mobile": "mobile",
"avatarUrl": "",
"threadCount": 30,
"followCount": 0,
"fansCount": 0,
"follow": null,
"status": 0,
"signature": "这是签名",
"loginAt": "2020-02-13T11:42:27+08:00",
"joinedAt": "2019-12-16T19:41:17+08:00",
"expiredAt": "2020-02-19T18:26:52+08:00",
"createdAt": "2019-12-16T19:41:17+08:00",
"updatedAt": "2020-02-13T15:45:15+08:00",
"canEdit": true,
"canDelete": true,
"canWalletPay": true,
"registerReason": "",
"banReason": "",
"originalMobile": "mobile",
"registerIp": "192.168.10.1",
"lastLoginIp": "192.168.10.1",
"identity": "",
"realname": "",
"paid": null,
"payTime": null,
"unreadNotifications": 8,
"usernameBout": 0,
"typeUnreadNotifications": {
"replied": 8
}
}
}
}
← 删除用户头像 批量修改用户的用户组 →