sms-verification

## ⚠️ 适用范围警告 **本插件不适用于登录/注册场景的手机验证码。** 如果需求是「用户注册或登录时验证手机号」，必须使用 Supabase Auth 原生接口，而不是本插件： ```ts // Step 1: Send OTP（发送验证码） const { error } = await supabase.auth.signInWithOtp({ phone: "+86" + phoneNumber, }); // Step 2: Verify OTP（验证验证码 → 完成登录） const { data, error } = await supabase.auth.verifyOtp({ phone: "+86" + phoneNumber, token: otpCode, type: "sms", }); ``` 原因：本插件维护自己独立的 SMS 状态（sessionId），与 Supabase Auth OTP 流程并行运行，会导致双重发送、状态不同步或静默失败。 **本插件的适用场景：** 与登录无关的业务短信验证，例如支付确认、操作二次验证、手机绑定等。 --- ## 能力概述 本插件提供完整的短信验证码发送与验证流程，包含两个接口： | 接口 | 端点 | 说明 | |------|------|------| | 发送短信验证码 | POST `https://app-bo4w33bsdqm9-api-W9z3M74x6ZNL-gateway.appmiaoda.com/v1/code/send_message` | 向指定手机号发送验证码，返回 sessionId | | 验证短信验证码 | POST `https://app-bo4w33bsdqm9-api-Xa6JZxjyqK0a-gateway.appmiaoda.com/v1/code/verify_message_code` | 根据 sessionId + 手机号 + 验证码进行校验 | **核心流程：** 1. 调用"发送"接口，传入手机号（可选 sessionId），获得 `sessionId` 2. 用户收到验证码后，调用"验证"接口，传入 sessionId、手机号、验证码，返回验证结果 **认证方式：** `platform_managed`，密钥由平台注入（`INTEGRATIONS_API_KEY`） - Auth Header 为 `X-Gateway-Authorization: Bearer ${INTEGRATIONS_API_KEY}`（注意不是标准的 `Authorization`）。 **支持平台：** Web、MiniProgram 详细参数表和代码实现见： - `references/send-message-api.md` — 发送短信验证码接口 - `references/verify-message-code-api.md` — 验证短信验证码接口 --- ## 生成期用法（Agent 直接调用） 认证模式为 `platform_managed`，密钥从环境变量读取：`process.env["INTEGRATIONS_API_KEY"]`。 两个接口需依次调用：先发送，获得 sessionId 后再验证。 详见： - `references/send-message-api.md` — 发送接口生成期代码 - `references/verify-message-code-api.md` — 验证接口生成期代码 --- ## 生成后用法（应用内通过 Edge Function 调用） 每个接口对应一个独立 Edge Function，前端通过 `supabase.functions.invoke` 调用。 Web 和 MiniProgram 共用相同的 Edge Function，均返回 JSON 响应，无平台差异。 详见： - `references/send-message-api.md` — 发送接口 Edge Function + 前端代码 - `references/verify-message-code-api.md` — 验证接口 Edge Function + 前端代码