1. 获取用户详情

接口地址：/home/user/userDetail

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "id": 1013,
    "user_type": 2,
    "username": "test1013",
    "nickname": "张三",
    "cash_pwd": null,
    "user_money": 0,
    "email": "",
    "status": 1,
    "create_at": "2025-10-28 21:44:40",
    "ip": "127.0.0.1",
    "avatar": "http://localhost:2999/upload/image/20251029/4fdbd12e52dd5a068429b1d6c42e9e2c_690168a6d4ad4.png",
    "has_user_collect": 0
  }
}

字段说明：

• id：用户ID
• user_type：用户类型（1-商户，2-普通用户）
• username：用户名
• nickname：昵称；未设置时后端按 username 生成默认昵称
• cash_pwd：二级密码状态（不为null表示已设置，null表示未设置）
• user_money：用户余额
• email：邮箱
• status：用户状态（1-正常）
• create_at：创建时间
• ip：注册IP地址
• avatar：头像URL
• has_user_collect：是否已设置收款信息，0=未设置，1=已设置

2. 文件上传

接口地址：/home/user/upload

请求参数：

参数名	类型	必填	说明
file	File	是	上传的文件
type	String	否	文件类型，默认为 image

响应示例：

{
  "code": 1,
  "msg": "上传成功",
  "data": "https://example.com/uploads/xxx.jpg"
}

3. 设置用户头像

接口地址：/home/user/setAvatar

请求参数：

参数名	类型	必填	说明
avatar	String	是	头像URL地址

响应示例：

{
  "code": 1,
  "msg": "保存成功",
}

4. 设置用户昵称

接口地址：/home/user/setNickname

请求参数：

参数名	类型	必填	说明
nickname	String	是	昵称，1-10 个字符

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

说明：

• username 继续作为系统用户名/账号标识使用，昵称展示请优先使用 nickname
• 如果用户未设置昵称，详情接口会返回后端生成的默认昵称

5. 启用恢复邮箱 / 换绑邮箱

接口地址：POST /home/user/bindEmail，需要用户登录。

参数名	类型	必填	说明
email	String	是	待绑定的新邮箱
code	String	是	严格 6 位 ASCII 数字验证码，例如 123456

{"code":1,"msg":"已启用邮箱恢复","data":{"email":"new@example.com","enabled":true}}

验证码绑定当前登录账户及目标邮箱，有效期 5 分钟，最多 5 次错误，成功即消费。换绑只替换当前账户邮箱，验证码失败保留原地址。

6. 发送恢复邮箱验证码

接口地址：POST /home/user/sendEmailCode，需要用户登录。

请求 {"email":"new@example.com"}。

{"code":1,"msg":"发送成功","data":{"retry_after":60,"expires_in":300,"code_length":6}}

验证码为 6 位数字，同账户 60 秒发送冷却，邮件失败不生成挑战，接口不返回验证码。详细错误规则和恢复状态接口见 V3账户与访问设置。

7. 绑定QQ

接口地址：/home/user/bindQq

请求参数：

参数名	类型	必填	说明
qq	String	是	QQ号码

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

8. 设置二级密码

接口地址：/home/user/setCashPwd

请求参数：

参数名	类型	必填	说明
cash_pwd	String	是	二级密码
email_code	String	否	邮箱验证码（修改时必填）

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

说明：

• 首次设置二级密码不需要邮箱验证码
• 修改二级密码需要先调用发送二级密码邮箱验证码接口

9. 发送二级密码邮箱验证码

接口地址：/home/user/sendEmailCodeForCashPwd

请求参数：无需参数，使用当前登录用户的邮箱

响应示例：

{
  "code": 1,
  "msg": "发送成功"
}

说明：

• 需要用户已绑定邮箱
• 验证码有效期为5分钟

10. 获取数据时效性

接口地址：/home/user/getDataCycle

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "data_cycle": 40 // 数据时效性表示查询历史数据的天数范围
  }
}

11. 保存数据时效性

接口地址：/home/user/saveDataCycle

请求参数：

参数名	类型	必填	说明
data_cycle	Integer	是	数据周期，可选值：7、15、40

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

说明：数据周期只能设置为 7天、15天 或 40天