接口支持 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,状态报告推送时返回此参数
请求示例1http://IP:PORT/msg/HttpBatchSendSM?account=test01&pswd=123456&mobile=18900000000,13800138000&msg=test&needstatus=true&product=flashsms&templateId=20200615114531100003000004
文本响应格式文本方式响应格式如下:
12resptime(响应时间),respstatus(响应状态)msgid
短信提交响应分为两行(每行以换行符(0x0a,即\n)分割),第一行为响应时间和状态,第二行为服务器给出提交msgid,一个发送请求只返回一个msgid。如果响应的状态不是“0”,或者提交时needstatus不等于true,则没有msgid,即第二行数据为空。
提交成功示例1220110725160412,0, //响应时间为20110725160412,响应状态为0 表明成功提交到服务器1234567890100 //返回的msgid,供状态报告匹配时使用。
提交失败示例1220110725160412,101 //响应时间为20110725160412,响应状态为101表示提交失败,请查询状态码 //服务器端并未返回msgid。
json响应格式提交成功示例123456{ "ts": "20110725160412", //响应时间 "result": 0, //响应状态,0表示成功 "msgid": "1234567890100" //状态匹配使用,如果响应的状态不是0,或者 //提交时needstatus不等于true,则没有msgid字段}
提交失败示例12345{ "ts": "20110725160412", //ts为响应时间 "result": 102 //响应状态102表示失败,请查询状态码说明 //服务器端并未返回msgid}
状态码返回详情查询状态码返回