Skip to content

短信渠道 ​

SYS-SMS-01 | 模块 system | 接入阿里云、腾讯云、华为云等短信服务商,并按渠道管理密钥与签名。

1. 使用角色与场景 ​

角色:管理员

  • 新增一个短信渠道并设为默认
  • 短信发送失败时切换备用渠道

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/system/sms-channel/createsystem:sms-channel:create创建短信渠道SmsChannelController#L33
PUT/system/sms-channel/updatesystem:sms-channel:update更新短信渠道SmsChannelController#L40
DELETE/system/sms-channel/deletesystem:sms-channel:delete删除短信渠道SmsChannelController#L48
DELETE/system/sms-channel/delete-listsystem:sms-channel:delete批量删除短信渠道SmsChannelController#L57
GET/system/sms-channel/getsystem:sms-channel:query获得短信渠道SmsChannelController#L66
GET/system/sms-channel/pagesystem:sms-channel:query获得短信渠道分页SmsChannelController#L75
GET/system/sms-channel/list-all-simple—获得短信渠道精简列表SmsChannelController#L83
GET/system/sms-channel/simple-list—获得短信渠道精简列表SmsChannelController#L83

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/sms/SmsChannelController.java#L33
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/sms/SmsChannelDO.java

4. 数据表 ​

表DO
system_sms_channelSmsChannelDO

5. 机制与配置 ​

  • SmsClient 抽象 + 各厂商实现 + 工厂按渠道编码取客户端
  • 渠道可配置签名与模版映射

6. 常见问题与排查 ​

  • 密钥权限不足时返回码容易被误判为业务失败

7. 关联 ​