Skip to content

短信模版、日志与回调 ​

SYS-SMS-02 | 模块 system | 维护短信模版并记录每条短信的发送结果,同时接收服务商的状态回执。

1. 使用角色与场景 ​

角色:管理员、运维

  • 新增验证码模版并提交审核
  • 按手机号查短信是否送达
  • 接收运营商回执更新状态

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/system/sms-template/createsystem:sms-template:create创建短信模板SmsTemplateController#L43
PUT/system/sms-template/updatesystem:sms-template:update更新短信模板SmsTemplateController#L50
DELETE/system/sms-template/deletesystem:sms-template:delete删除短信模板SmsTemplateController#L58
DELETE/system/sms-template/delete-listsystem:sms-template:delete批量删除短信模板SmsTemplateController#L67
GET/system/sms-template/getsystem:sms-template:query获得短信模板SmsTemplateController#L76
GET/system/sms-template/pagesystem:sms-template:query获得短信模板分页SmsTemplateController#L85
GET/system/sms-template/list-all-simple—获得短信模板精简列表SmsTemplateController#L93
GET/system/sms-template/simple-list—获得短信模板精简列表SmsTemplateController#L93
GET/system/sms-template/export-excelsystem:sms-template:export导出短信模板 ExcelSmsTemplateController#L101
POST/system/sms-template/send-smssystem:sms-template:send-sms发送短信SmsTemplateController#L114
GET/system/sms-log/pagesystem:sms-log:query获得短信日志分页SmsLogController#L41
GET/system/sms-log/getsystem:sms-log:query获得短信日志SmsLogController#L49
GET/system/sms-log/export-excelsystem:sms-log:export导出短信日志 ExcelSmsLogController#L58
POST/system/sms/callback/aliyun—阿里云短信的回调SmsCallbackController#L26
POST/system/sms/callback/tencent—腾讯云短信的回调SmsCallbackController#L36
POST/system/sms/callback/huawei—华为云短信的回调SmsCallbackController#L47
POST/system/sms/callback/qiniu—七牛云短信的回调SmsCallbackController#L56

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/sms/SmsTemplateController.java#L43
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/sms/SmsLogController.java#L41
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/sms/SmsCallbackController.java#L26
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/sms/SmsTemplateDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/sms/SmsLogDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/sms/SmsCodeDO.java

4. 数据表 ​

表DO
system_sms_templateSmsTemplateDO
system_sms_logSmsLogDO
system_sms_codeSmsCodeDO

5. 机制与配置 ​

  • 模版参数为 JSON;发送结果异步回写
  • 验证码单独存 Redis 并设有效期

6. 常见问题与排查 ​

  • 回调接口需放行鉴权,同时校验签名防伪造

7. 关联 ​