5. 用户与认证 API 5.1 发送短信验证码【参数校验通过，待业务联调】

Table of Contents

5.1 发送短信验证码【参数校验通过，待业务联调】

POST /tieup/api/v1/auth/sms-codes

请求体：

{
  "phone": "13800000000",
  "scene": "register"
}

请求参数：

参数 类型 必填 说明
phone string 是 中国大陆 11 位手机号
scene string 是 login/register/reset_password/change_phone/bind_phone

响应字段：

字段 类型 说明
success boolean 操作是否成功

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "success": true
  }
}

说明：scene 对应短信模板场景，可取 login、register、reset_password、change_phone、bind_phone。短信供应商和限流配置来自 tieup_sms_config。验证码校验在默认消费模式下使用 Redis Lua compare-and-delete 原子删除，避免并发请求重复消费同一验证码。

测试状态：已完成代码实现和 PHP 语法检查，待短信供应商或测试短信配置联调。