1. 获取用户详情 （用于面板中持久化保存用户信息）

接口地址： /merchantapi/user/user/userdetail

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "user": {
      "id": 1000,
      "username": "test1000", //用户名
      "email": "", //邮箱
      "is_freeze": 0, // 商户账号冻结状态：0=正常，1=已冻结
      "create_at": "2025-11-19 00:29:41", //店铺(商户账号)开通时间
      "avatar": "https://fast.qqss.net/static/common/images/noavatar.png", // 用户头像
      "has_cash_pwd": true //是否已设置二级密码 
    },
    "perms": ["merchantapi/workbench/index", "merchantapi/shop/link/index"] //用户权限列表
  }
}

2. 设置用户头像

接口地址： /merchantapi/user/user/setAvatar

请求方式： POST

请求参数：

参数名	类型	必填	说明
avatar	string	是	头像 URL

响应示例：

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

---

3. 绑定邮箱

接口地址： /merchantapi/user/user/bindEmail

请求方式： POST

请求参数：

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

响应示例：

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

---

4. 绑定 QQ

接口地址： /merchantapi/user/user/bindqq

请求方式： POST

请求参数：

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

响应示例：

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

---

5. 发送绑定邮箱验证码

接口地址： /merchantapi/user/user/sendEmailCode

请求方式： POST

请求参数：

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

响应示例：

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

说明： 验证码有效期 5 分钟，前端请做1分钟限流

---

6. 设置二级密码

接口地址： /merchantapi/user/user/setCashPwd

请求方式： POST

请求参数：

参数名	类型	必填	说明
cash_pwd	string	是	二级密码
email_code	string	否	邮箱验证码（首次设置无需填写。修改时必填）

响应示例：

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

业务规则：

• 首次设置：只需要提供 cash_pwd
• 修改密码：需要提供 cash_pwd 和 email_code

---

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

接口地址： /merchantapi/user/user/sendEmailCodeForCashPwd（使用当前用户的邮箱）

响应示例：

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

说明：

• 发送至用户邮箱地址，没有绑定邮箱时会提示 邮箱不能为空
• 验证码有效期5分钟，前端请做1分钟限流