1. 获取用户详情

接口地址：/home/user/userDetail

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "id": 1013,
    "user_type": 2,
    "username": "test1013",
    "cash_pwd": null,
    "money": 0,
    "freeze_money": 0,
    "deposit_money": 0,
    "user_money": 0,
    "cash_type": 1,
    "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",
    "user_data_cycle": 40
  }
}

字段说明：

• id：用户ID
• user_type：用户类型（1-商户，2-普通用户）
• username：用户名
• cash_pwd：二级密码状态（不为null表示已设置，null表示未设置）
• user_money：用户余额
• cash_type：提现方式（1-自动提现，2-手动提现，3-定额提现）
• email：邮箱
• status：用户状态（1-正常）
• create_at：创建时间
• ip：注册IP地址
• avatar：头像URL
• user_data_cycle：用户数据周期（天数，默认40天）

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/bindEmail

请求参数：

参数名	类型	必填	说明
email	String	是	邮箱地址
email_code	String	是	邮箱验证码

响应示例：

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

5. 发送邮箱验证码

接口地址：/home/user/sendEmailCode

请求参数：

参数名	类型	必填	说明
email	String	是	邮箱地址

响应示例：

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

• 验证码有效期为5分钟

6. 绑定QQ

接口地址：/home/user/bindQq

请求参数：

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

响应示例：

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

7. 设置二级密码

接口地址：/home/user/setCashPwd

请求参数：

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

响应示例：

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

说明：

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

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

接口地址：/home/user/sendEmailCodeForCashPwd

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

响应示例：

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

说明：

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

9. 获取数据时效性

接口地址：/home/user/getDataCycle

响应示例：

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

10. 保存数据时效性

接口地址：/home/user/saveDataCycle

请求参数：

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

响应示例：

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

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