diff --git a/docs/superpowers/specs/2026-05-22-sms-register-design.md b/docs/superpowers/specs/2026-05-22-sms-register-design.md index ac85c0c..41816ff 100644 --- a/docs/superpowers/specs/2026-05-22-sms-register-design.md +++ b/docs/superpowers/specs/2026-05-22-sms-register-design.md @@ -352,7 +352,58 @@ SMS_REGION=cn-hangzhou --- -## 12. 待确定事项 +## 12. 阿里云短信服务详情 + +### 12.1 价格计费 + +| 计费项 | 说明 | +|--------|------| +| 国内短信 | 0.045 元/条(正常模板) | +| 国际/港澳台短信 | 按区域定价,详见 [阿里云短信定价页](https://www.aliyun.com/product/sms) | + +> ⚠️ **待确认**:请在实际使用前登录阿里云控制台确认最新价格,本文档价格仅供参考。 + +### 12.2 短信模板类型 + +| 模板类型 | 说明 | 审核时间 | +|----------|------|----------| +| 验证码模板 | 仅含变量(如 ${code}),用于发送随机验证码 | 通常 2 小时内 | +| 通知模板 | 含固定文本 + 少量变量 | 通常 2 小时内 | +| 推广模板 | 营销类内容,审核更严格 | 通常 4 小时以上 | + +**验证码模板示例:** +``` +您的注册验证码是${code},5分钟内有效。如非本人操作,请忽略此短信。 +``` + +### 12.3 签名 + +- 签名是短信发送者的标识,位于短信内容开头 +- 一个账号可创建多个签名,需审核通过后才能使用 +- 签名名称示例:`TopFans`、`TOPFANS官方` + +### 12.4 开通流程 + +1. 登录阿里云控制台 → 产品 → 短信服务 SMS +2. 完成企业认证(如尚未认证) +3. 创建短信签名:控制台 → 短信签名管理 → 新增签名 +4. 创建短信模板:控制台 → 短信模板管理 → 新增模板 +5. 获取 AccessKey:RAM 控制台 → 访问密钥 → 创建 AccessKey +6. 记录以下信息填入配置: + - AccessKey ID + - AccessKey Secret + - 签名名称(SignName) + - 模板 CODE(TemplateCode) + +### 12.5 相关文档 + +- [阿里云短信服务帮助文档](https://help.aliyun.com/zh/sms) +- [短信 API 调用指南](https://help.aliyun.com/zh/sms/developer-reference/sendSms) +- [Go SDK 文档](https://help.aliyun.com/zh/sms/developer-reference/aliyun-java-sdk-sms) + +--- + +## 13. 待确定事项 - [ ] 阿里云短信签名和模板CODE(需在阿里云控制台创建) - [ ] 验证码有效期(默认 60 秒是否合适)