通过手机号和短信验证码实现用户快速登录或自动注册。
当用户要求:发送手机验证码、用手机号登录、用验证码登录、手机号注册 时,使用此 skill。
SMS_LOGIN_BASE_URL 已设置为 API 服务器地址curl 和 jq向用户确认手机号后,发送验证码:
curl -s -X POST "${SMS_LOGIN_BASE_URL}/api/v1/auth/phone/send" \
-H "Content-Type: application/json" \
-d '{"phone": "'"${PHONE}"'"}' | jq .
| 条件 | 含义 | 下一步 |
|---|---|---|
| ------ | ------ | -------- |
code == 200 | 发送成功 | 提示用户查看短信,进入步骤二 |
| HTTP 400 | 手机号格式错误 | 提示用户检查手机号,重新输入 |
code == 500 | 限流或系统错误 | 展示 message 内容,稍后重试 |
向用户索要短信中的验证码后,发起登录:
curl -s -c - -X POST "${SMS_LOGIN_BASE_URL}/api/v1/auth/phone/login" \
-H "Content-Type: application/json" \
-d '{"phone": "'"${PHONE}"'", "code": "'"${CODE}"'"}' | jq .
| 条件 | 含义 | 下一步 |
|---|---|---|
| ------ | ------ | -------- |
code == 200 | 登录成功 | 从 data.token 提取 token,后续请求用 Authorization: Bearer |
| HTTP 400 | 参数缺失/格式错误 | 提示用户重新输入 |
code == 401 | 验证码错误或已过期 | 建议用户重新获取验证码,回到步骤一 |
登录成功时,响应头会设置 Set-Cookie: token=,浏览器场景会自动维持会话。
共 1 个版本