使用模板id下发
提交方式:
支持https
只支持POST
功能:
发送一条或者多条内容相同的短信(模板上传之后,把短信内容通过短信下发接口发送,我们后台也会自动匹配短信内容到相应模板,没有必要一定使用模板id下发)
请求参数:
参数值说明:以下json内容为提交请求数据格式
{
"account":"dh****",
"password":"e717ebfd5271ea4a98bd38653c01113d",
"msgid":"2c92825934837c4d0134837dcba00150",
"phones":"1571166****",
"template":{"id":"d65b268cba2243d8a4b15f22f9e847d8","variables":[{"name":"1","value":"内容1"},{"name":"2","value":"内容2"}]},
"subcode":"",
"sendtime":"201405051230"
}
参数名 | 必要性 | 说明 |
---|---|---|
account | 必填 | 用户账号 |
password | 必填 | 密码,需采用MD5加密(32位小写) ,如调用大汉三通提供jar包的话使用明文 |
phones | 必填 | 接收手机号码,多个手机号码用英文逗号分隔,最多1000个,国际号码格式为+国别号手机号,号码示例:+85255441234 |
template | 必填 | 短信模板格式,id对应模板id,variables对应模板内容的键值对集合,name对应变量内容序号(序号从1开始,必填),value对应具体内容; |
msgid | 选填 | 该批短信编号(32位UUID),需保证唯一,不填的话响应里会给一个系统生成的 |
subcode | 选填 | 短信签名对应子码(大汉三通提供)+自定义扩展子码(选填),必须是数字,未填使用签名对应子码,无法前匹配签名对应子码则使用签名对应子码+所填子码,通常建议不填 |
sendtime | 选填 | 定时发送时间,格式yyyyMMddHHmm,为空或早于当前时间则立即发送 |
params | 选填 | 终端客户自定义参数params(总长度限制为1000),参数类型为Map,如果携带此参数会在状态报告里返回,示例:”params”:{“param1”:”aaa”,”param2”:”bbb”} |
该响应为提交响应,发送到手机是否成功请获取状态报告确认该响应为提交响应,发送到手机是否成功请获取状态报告确认
返回示例:
{
"msgid":"f02adaaa99c54ea58d626aac2f4ddfa8",
"result":"0",
"desc":"提交成功",
"failPhones":"12935353535,110,130123123"
}
返回参数说明:
参数名 | 说明 |
---|---|
desc | 状态描述 |
msgid | 该批短信编号 |
result | 该批短信提交结果;说明请参照:提交响应错误码 |
failPhones | 如果提交的号码中含有错误(格式)号码将在此显示 |
文档更新时间: 2021-01-20 16:49 作者:夏亮