短信发送
一、单条短信发送
1.1 请求地址
地址:https://www.8dx.cn/api/send-sms-single
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON
1.2 请求参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| sp_id | 产品sp_id | 175298 | 是 |
| signature | 签名(和密码二选一即可) | a92569901189f2574effc957c096c432e2d47635 | 否 |
| password | 密码(和签名二选一即可),通过sp_id的密码进行md5处理 | 60465589668c72c8f2eb560050ac4c0c | 否 |
| mobile | 手机号码 | 136xxxxxxxxx(支持aes加密) | 是 |
| content | 短信内容 | 【测试】验证码123(支持aes加密) | 是 |
| ext | 扩展号 | 123 | 否 |
1.3 响应参数
| 参数名 | 参数介绍 | 示例 |
|---|---|---|
| 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 请求参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| 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 响应参数
| 参数名 | 参数介绍 | 示例 |
|---|---|---|
| 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 请求参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| sp_id | 产品sp_id | 175298 | 是 |
| signature | 签名(和密码二选一即可) | a92569901189f2574effc957c096c432e2d47635 | 否 |
| password | 密码(和签名二选一即可),通过sp_id的密码进行md5处理 | 60465589668c72c8f2eb560050ac4c0c | 否 |
| params | 变量参数,多条短信以英文;分割,多个变量之间以英文,分割,变量前带上手机号 | 136xxxxxxxxx,822233;138xxxxxxxxx,656552 | 是 |
| content | 短信内容 | 【测试签名】验证码${变量} | 是 |
| ext | 扩展号 | 123 | 否 |
3.3 响应参数
| 参数名 | 参数介绍 | 示例 |
|---|---|---|
| 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 请求参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| sp_id | 产品sp_id | 175298 | 是 |
| signature | 签名(和密码二选一即可) | a92569901189f2574effc957c096c432e2d47635 | 否 |
| password | 密码(和签名二选一即可),通过sp_id的密码进行md5处理 | 60465589668c72c8f2eb560050ac4c0c | 否 |
| params | 一对一参数,json格式key是手机号,value是内容 | {"136xxxxxxxx":"变量A111","133xxxxxxxx":"变量A222"} | 是 |
| ext | 扩展号 | 123 | 否 |
4.3 响应参数
| 参数名 | 参数介绍 | 示例 |
|---|---|---|
| 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对接方式快速选型对照表
| 发送模式 | 内容是否统一 | 核心优势 | 最佳业务场景 |
|---|---|---|---|
| 单条发送 | 自定义单次文案 | 极简、临时单点沟通 | 测试、单独客户沟通、零散通知 |
| 批量短信(无变量) | 全部相同 | 低成本、高速群发 | 全员公告、通用营销、统一通知 |
| 变量短信发送 | 每条带专属信息 | 批量 + 个性化兼顾 | 订单、账单、还款、会员通知 |
| 一对一批量发送 | 可搭配变量,发送链路独立 | 防拦截、分时段、精细化触达 | 高端客户回访、逾期温和提醒、分时段推送 |