5. 用户与认证 API 5.9 找回密码【参数校验通过，待业务联调】

Table of Contents

5.9 找回密码【参数校验通过，待业务联调】

POST /tieup/api/v1/auth/password-reset

请求体：

{
  "phone": "13800000000",
  "sms_code": "123456",
  "new_password": "new_password"
}

请求参数：

参数 类型 必填 说明
phone string 是 中国大陆 11 位手机号
sms_code string 是 6 位数字验证码
new_password string 是 6 到 64 位新密码

响应字段：

字段 类型 说明
data array 响应业务数据，当前接口成功时为空数组

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": []
}

说明：

  • 服务端按 X-App-Channel + phone 查找账号。
  • 验证 reset_password 场景短信验证码后更新密码哈希。
  • 找回密码接口按 channel_code + phone 做 Redis 限流，默认 300 秒最多 5 次。
  • 测试状态：已完成代码实现和 PHP 语法检查，待短信验证码联调。