/sms/addSmsCardLog
在用管理后台
#
发卡短信记录-新增 · SmsCardLogController
基本信息
| 控制器 | com.jxxx.dscp.api.controller.sms.SmsCardLogController#addSmsCardLog |
|---|---|
| 所属模块 | 短信 sms |
| 暴露渠道 | 管理后台 （@Route 注解；决定 URL 前缀与可访问端） |
| 请求方法 | POST |
调用链路 & 涉及数据表
涉及数据表
sms_card_logsms_configController
SmsCardLogController#addSmsCardLog转换BeanUtils.map →
SmsCardLog ⇒ 表 sms_card_logService
SmsConfigService#get （SmsConfigServiceImpl）Mapper
SmsConfigMapper#selectById ⇒ 表 sms_configService
SmsCardLogService#add （SmsCardLogServiceImpl）Mapper
SmsCardLogMapper#insert ⇒ 表 sms_card_log其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1
SmsService.sendSms
链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。
环境 URL
| 环境 | 完整 URL（主机 + 渠道前缀 + 路径） | 备注 |
|---|---|---|
| dev | https://dscp-dev.hn12301.net/manage-api/sms/addSmsCardLog | |
| uat | https://dscp-uat.hn12301.net/manage-api/sms/addSmsCardLog | |
| pro | https://dscp-uat.hn12301.net/manage-api/sms/addSmsCardLog | （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意） |
请求参数 · Header / Query / Path
无（该接口无 Query/Path/Header 显式参数；入参见 Body）
请求参数 · Body
SmsCardLogAddRequest| 字段 | 类型 | 必填 | 取值/校验 | 表 / 列 | 说明 |
|---|---|---|---|---|---|
| signCode | String | sms_card_log.sign_code | 短信签名编码 | ||
| signContent | String | sms_card_log.sign_content | 短信签名内容 | ||
| templateId | Long | sms_card_log.template_id | 模板编号 | ||
| templateCode | String | sms_card_log.template_code | 模板编码 | ||
| templateType | Integer | sms_card_log.template_type | 短信类型 | ||
| templateContent | String | sms_card_log.template_content | 短信内容 | ||
| templateParams | String | sms_card_log.template_params | 短信参数 | ||
| mobile | String | sms_card_log.mobile | 手机号 | ||
| userId | Long | sms_card_log.user_id | 用户编号 | ||
| userType | Integer | sms_card_log.user_type | 用户类型 | ||
| sendStatus | SmsSendStatus | 1成功0失败 | sms_card_log.send_status | 发送状态 | |
| sendTime | Date | sms_card_log.send_time | 发送时间 | ||
| sendCode | String | sms_card_log.send_code | 发送结果的编码 | ||
| sendMsg | String | sms_card_log.send_msg | 发送结果的提示 | ||
| receiveStatus | SmsSendStatus | 1成功0失败 | sms_card_log.receive_status | 接收状态 | |
| receiveTime | Date | sms_card_log.receive_time | 接收时间 | ||
| creator | String | sms_card_log.creator | 创建者 | ||
| createTime | Date | sms_card_log.create_time | 创建时间 | ||
| updater | String | sms_card_log.updater | 更新者 | ||
| updateTime | Date | sms_card_log.update_time | 更新时间 | ||
| deleted | Boolean | sms_card_log.deleted | 是否删除 |
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
| errcode | int | 业务码，0=成功 |
| errmsg | string | 提示信息 |
| data | T | 下方“data 结构” |
data 结构
void —— 无返回数据
示例
请求示例 （自动生成，仅结构参考）
POST /sms/addSmsCardLog{
"body": {
"signCode": "",
"signContent": "",
"templateId": 1,
"templateCode": "",
"templateType": 0,
"templateContent": "",
"templateParams": "",
"mobile": "13800000000",
"userId": 1,
"userType": 0,
"sendStatus": "1",
"sendTime": "2026-01-01 12:00:00",
"sendCode": "",
"sendMsg": "",
"receiveStatus": "1",
"receiveTime": "2026-01-01 12:00:00",
"creator": "",
"createTime": "2026-01-01 12:00:00",
"updater": "2026-01-01 12:00:00",
"updateTime": "2026-01-01 12:00:00",
"deleted": false
}
}响应示例
（void，无响应体）
处理逻辑
操作日志sms / 新增短信记录
逻辑摘要查询详情（smsConfigService.get）；调用 sendSms（smsService.sendSms）；调用 toBean（JSONUtil.toBean）；入参与返回值经 BeanUtils 做对象/分页映射
内联注释
- 发送短信
- if (template.getCode().startsWith("SMS_")) { // 测试消息不发送
- }