闪信发送

接口支持 HTTP / HTTPS 请求方式（支持 GET & POST ），参数格式为 FormData。
使用 POST 方式发送时，需要使用 urlencode 编码 。

发送接口

协议说明

协议类目 说明
调用地址 http://IP:PORT/msg/HttpBatchSendSM
请求方式 POST，GET
编码格式 UTF-8
Content-Type application/x-www-form-urlencoded;charset=utf-8

请求参数

参数 必填 描述
account 是 用户账号
ts 否 时间戳，格式yyyyMMddHHmmss
pswd 是 用户密码,ts参数为空时填明文密码，ts参数不为空时填md5(账号+密码+时间戳)，对账号密码时间戳拼接的字符串进行md5加密，小写32位
mobile 否 合法的手机号码，号码间用英文逗号分隔
fileId 否 上传的符合条件的手机号文件：支持：”.txt,.xlsx,.xls格式”
templateId 是 模板ID,发送前报备模板
msg 是 模板变量对应的参数如：{name:’张先生’，tel:’133xxxx3333’}
needstatus 否 是否需要状态报告，填true表示需要状态报告；不填或者填其他值表示不需要状态报告
product 是 产品编码:flashsms
extno 否 子扩展码（用户定义扩展码），建议用户扩展3位，提交限制为6位
resptype 否 响应格式，默认返回文本格式，填json返回json格式
rid 否 客户发送短信时自行生成rid，状态报告推送时返回此参数

请求示例

1
http://IP:PORT/msg/HttpBatchSendSM?account=test01&pswd=123456&mobile=18900000000,13800138000&msg=test&needstatus=true&product=flashsms&templateId=20200615114531100003000004

文本响应格式

文本方式响应格式如下：

1
2
resptime（响应时间）,respstatus（响应状态）
msgid

短信提交响应分为两行（每行以换行符(0x0a,即\n)分割），第一行为响应时间和状态，第二行为服务器给出提交msgid，一个发送请求只返回一个msgid。如果响应的状态不是“0”，或者提交时needstatus不等于true，则没有msgid，即第二行数据为空。

提交成功示例

1
2
20110725160412,0, //响应时间为20110725160412,响应状态为0 表明成功提交到服务器
1234567890100     //返回的msgid,供状态报告匹配时使用。

提交失败示例

1
2
20110725160412,101 //响应时间为20110725160412,响应状态为101表示提交失败，请查询状态码
                   //服务器端并未返回msgid。

json响应格式

提交成功示例

1
2
3
4
5
6
{
      "ts": "20110725160412",  //响应时间
      "result": 0,             //响应状态,0表示成功
      "msgid": "1234567890100" //状态匹配使用,如果响应的状态不是0,或者
                               //提交时needstatus不等于true,则没有msgid字段
}

提交失败示例

1
2
3
4
5
{
      "ts": "20110725160412",  //ts为响应时间
      "result": 102            //响应状态102表示失败,请查询状态码说明
                               //服务器端并未返回msgid
}

状态码返回

详情查询状态码返回