1. 首页
  2. 秒信通MiCPaaS
  3. 🗊 国内短信
  4. 🗊 API接口
  5. 🗎 短信发送
菜单
本页目录

短信发送

一、单条短信发送

1.1 请求地址

地址:https://www.8dx.cn/api/send-sms-single
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON

1.2 请求参数

API参数表格
参数名 参数介绍 示例 必填
sp_id 产品sp_id 175298
signature 签名(和密码二选一即可) a92569901189f2574effc957c096c432e2d47635
password 密码(和签名二选一即可),通过sp_id的密码进行md5处理 60465589668c72c8f2eb560050ac4c0c
mobile 手机号码 136xxxxxxxxx(支持aes加密)
content 短信内容 【测试】验证码123(支持aes加密)
ext 扩展号 123

1.3 响应参数

API参数表格
参数名 参数介绍 示例
code 详情见错误表 0
msg 成功-success 错误-其他提示 success
msg_id 消息id,用来获取状态报告时候匹配是哪条消息,成功返回 17
data 失败有返回,详情见错误表 WL:NMLJ7

响应数据示例(JOSN):

{
    "code": 0,
    "msg": "success",
    "msg_id": 105184588
}
适用场景

单条短信发送

核心定义:单次仅给1 个手机号发送短信。

适用场景

1.临时一对一通知:验证码短信、订单通知、OA/ERP通知

2.内部员工单点提醒:单独通知某位同事加班、单独告知审批结果

3.测试短信:调试短信模板、校验通道、测试接收效果

4.零散零星通知:仅有单个用户需要推送,无批量名单

二、批量短信发送(无变量,统一内容)

2.1 请求地址

地址:https://www.8dx.cn/api/send-sms-batch
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON

2.2 请求参数

API参数表格
参数名 参数介绍 示例 必填
sp_id 产品sp_id 175298
signature 签名(和密码二选一即可) a92569901189f2574effc957c096c432e2d47635
password 密码(和签名二选一即可),通过sp_id的密码进行md5处理 60465589668c72c8f2eb560050ac4c0c
mobiles 批量手机号码 136xxxxxxxxx,138xxxxxxxx,139xxxxxxxx,130xxxxxxxx,...(支持aes加密)
content 短信内容 【测试】验证码123(支持aes加密)
ext 扩展号 123

2.3 响应参数

API参数表格
参数名 参数介绍 示例
code 详情见错误表 0
msg 成功-success 错误-其他提示 success
msg_id 消息id,用来获取状态报告时候匹配是哪条消息,批量发送的时候msg_id和该批次中的手机号形成唯一标志,成功返回 17
data 发送号码中失败的号码对应的错误码,全部成功则为空数组 {"1376xxxxxxxxx":"WL:CWHM","318xxxxxxxxx":"WL:CWHM"}

响应示例

{
    "code": 0,
    "msg": "success",
    "msg_id": 105184686,
    "failed_data": {}
}
适用场景

定义:导入 / 粘贴一批手机号,所有人收到完全一模一样的短信文案,无个性化内容。
适用场景:

1.通用营销推广:门店开业、节日普惠活动、全场优惠、公共活动通知

2.全员统一公告:企业全体员工放假通知、物业全体业主停水停电、园区防疫通知

3.统一验证码/通用告警:设备批量告警、平台统一系统维护公告

4.行业普惠通知:驾校统一上课提醒、培训机构全体开课通知等

特点:
1.黑名单等拦截错误实时返回,一次最多提交一万条
2.文案固定、批量高效、成本低;无法区分每个用户姓名、订单、专属信息

三、变量短信发送(模板动态替换变量)

3.1 请求地址

地址:https://www.8dx.cn/api/send-variable
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON

3.2 请求参数

API参数表格
参数名 参数介绍 示例 必填
sp_id 产品sp_id 175298
signature 签名(和密码二选一即可) a92569901189f2574effc957c096c432e2d47635
password 密码(和签名二选一即可),通过sp_id的密码进行md5处理 60465589668c72c8f2eb560050ac4c0c
params 变量参数,多条短信以英文;分割,多个变量之间以英文,分割,变量前带上手机号 136xxxxxxxxx,822233;138xxxxxxxxx,656552
content 短信内容 【测试签名】验证码${变量}
ext 扩展号 123

3.3 响应参数

API参数表格
参数名 参数介绍 示例
code 详情见错误表 0
msg 成功-success 错误-其他提示 success
msg_id 消息id,用来获取状态报告时候匹配是哪条消息,批量发送的时候msg_id和该批次中的手机号形成唯一标志,成功返回 17
failed_data 发送号码中失败的号码对应的错误码,全部成功则为空数组 {"136xxxxxxxxx":"WL:CWHM","138xxxxxxxxx":"WL:CWHM"}
应用提示

变量短信发送(模板动态替换变量)

核心定义统一模板内置占位变量(姓名、订单号、金额、到期日、卡号等),导入带字段的 Excel,系统自动填充变量,每条短信内容个性化。

适用场景

1.电商/零售订单通知:【XX商城】尊敬的({姓名},您的订单{订单号}已发货,物流单号${物流单号码}

2.金融信贷还款提醒:尊敬的{客户名},您贷款{金额} 将于${还款日}到期,请及时还款

3.会员专属通知:{会员名},您的会员卡将于{到期时间}过期,剩余积分${积分}

4.政务/物业个性化账单:业主{姓名},您本月物业费{费用} 请于${截止日}缴纳

5.教育机构学员通知:{学生姓名}家长,您孩子{班级} 本周六${时间}到校补课

特点:千人千面,高度个性化;需要规范表格字段,适合有用户专属数据的业务

四、一对一批量发送(分批次一对一、独立触达逻辑)

4.1 请求地址

地址:https://www.8dx.cn/api/send-biunique
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON

4.2 请求参数

API参数表格
参数名 参数介绍 示例 必填
sp_id 产品sp_id 175298
signature 签名(和密码二选一即可) a92569901189f2574effc957c096c432e2d47635
password 密码(和签名二选一即可),通过sp_id的密码进行md5处理 60465589668c72c8f2eb560050ac4c0c
params 一对一参数,json格式key是手机号,value是内容 {"136xxxxxxxx":"变量A111","133xxxxxxxx":"变量A222"}
ext 扩展号 123

4.3 响应参数

API参数表格
参数名 参数介绍 示例
code 详情见错误表 0
msg 成功-success 错误-其他提示 success
msg_id 消息id,用来获取状态报告时候匹配是哪条消息,批量发送的时候msg_id和该批次中的手机号形成唯一标志,成功返回 17
failed_data 发送号码中失败的号码对应的错误码,全部成功则为空数组 {"136xxxxxxxxx":"WL:CWHM","138xxxxxxxxx":"WL:CWHM"}
应用提示

一对一批量发送(分批次一对一、独立触达逻辑)

核心定义:

批量导入号码,但每条视为独立单发链路,可设置间隔发送、分时段推送、单独回执、单独签名,模拟人工一对一发送,区别于普通变量批量。

适用场景

1.高客单价客户精细化触达:房产、汽车、高端医美销售跟进,避免群发标签,提升客户体验;

2.售后回访批量任务:上千客户售后回访,错开发送时间,防止被运营商判定垃圾短信;

3.高敏感风控通知:信贷逾期温和提醒、保险续保一对一关怀,降低投诉率;

4.多时段定时分批推送:分早中晚错开发送,避免同一时间大量并发导致通道拥堵;

5.需单独记录每条沟通记录场景:每条短信独立日志、单独回复关联、单独状态回执.

和变量短信核心区别

变量短信:侧重内容个性化,并发量大、速度快;

一对一批量:侧重发送行为一对一,可控发送间隔、防风控、模拟人工单发,速度可控放缓。

API对接方式快速选型对照表

短信发送模式对比表
发送模式 内容是否统一 核心优势 最佳业务场景
单条发送 自定义单次文案 极简、临时单点沟通 测试、单独客户沟通、零散通知
批量短信(无变量) 全部相同 低成本、高速群发 全员公告、通用营销、统一通知
变量短信发送 每条带专属信息 批量 + 个性化兼顾 订单、账单、还款、会员通知
一对一批量发送 可搭配变量,发送链路独立 防拦截、分时段、精细化触达 高端客户回访、逾期温和提醒、分时段推送