短信下发
提交方式:
支持https
只支持POST
功能:
发送一条或者多条内容相同的短信, 适用于之前对接过其他供应商签名在内容里,不方便另外写一个字段的客户
请求参数:
参数值说明:以下json内容为提交请求数据格式
{
"account":"dh****",
"password":"e717ebfd5271ea4a98bd38653c01113d",
"msgid":"2c92825934837c4d0134837dcba00150",
"phones":"1571166****,1571165****",
"content":"【大汉三通】您好,您的手机验证码为:430237。",
"subcode":"",
"sendtime":"201405051230"
}
参数名 | 必要性 | 说明 |
---|---|---|
account | 必填 | 用户账号 |
password | 必填 | 密码,需采用MD5加密(32位小写) ,如调用大汉三通提供jar包的话使用明文 |
phones | 必填 | 接收手机号码,多个手机号码用英文逗号分隔,最多1000个,国际号码格式为+国别号手机号,号码示例:+85255441234(国际手机号前如果带0会去0后下发) |
content | 必填 | 短信内容,最多1000个汉字,内容首尾出现【】[]这两种方括号会作为签名使用 |
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:39 作者:夏亮