普通短信发送

发送接口

协议说明

用户通过HTTP的POST、GET方式提交短信发送

协议类目 说明
调用地址 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加密
mobile 合法的手机号码,多个手机号码间用英文逗号分隔
msg 短信内容,长度不能超过700个字符。使用URL方式编码为UTF-8格式。短信内容超过70个字符时,会被拆分成多条,然后以长短信的格式发送。
needstatus 是否需要状态报告,填true表示需要状态报告;不填或者填其他值表示不需要状态报告
product 产品编码:sms,不填写默认是普通短信发送。
extno 扩展码,用户自定义扩展码
resptype 响应格式,默认返回文本格式,填json返回json格式
templateId 短信模板
rid 客户发送短信时自行生成rid,状态报告推送时返回此参数

请求示例

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

文本响应格式

文本方式响应格式如下:

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
}

状态码说明

详情查询状态码