洪度阳晨短信包发送接口_洪度阳晨短信群发平台
您当前的位置:首页 >> 文章中心 >> 技术分享

洪度阳晨短信包发送接口

用户通过HTTPPOST方式提交短信发送请求。

1.1   接口地址

http://IP:PORT/msg/HttpPkgSM

1.2   参数定义

序号

参数

说明

1

ac

用户账号

2

ts

可选参数,时间戳,格式yyyyMMddHHmmss

3

pswd

必填参数。用户密码,ts参数为空时填明文密码,ts参数不为空时填md5(账号+密码+时间戳),对账号密码时间戳拼接的字符串进行md5加密

4

msg

发送包内容,格式为:mobile|content ,内容编码为utf-8格式。

 

……

……

5

msg

n个短信号码及内容,n<=1000

6

needstatus

是否需要状态报告,取值truefalsetrue,表明需要状态报告;false不需要状态报告

7

product

用户订购的产品id,不填写(针对老用户)系统采用用户的默认产品。

8

extno

可选参数,扩展码,用户定义扩展码,3,实际提交限制为6位,建议用户扩展3

9

resptype

可选参数,响应格式,默认返回文本格式,填json返回json格式

 

1.3   提交响应

1.3.1    文本格式说明

格式如下

resptime,respstatus,successnum,failnum

msgid

Ø  提交成功

20110725160412,0,10,1

1234567890100

响应时间为20110725160412,响应状态为0 表明成功提交到服务器,参数组个数为10表明提交参数params中格式正确的条数为10, 发送包失败个数为1表明提交参数msg中格式错误的条数为1条;1234567890100为返回的msgid,供状态报告匹配时使用。

Ø  提交失败

20110725160412,101

本示例表明用户提交失败,返回错误码为101,服务器端并未返回msgid

1.3.2    JSON格式说明

{

      "ts": "20110725160412",

      "result": 0,

      "suc": 10,

      "fail": 0,

      "msgid": "1234567890100"

}

ts为响应时间,result为响应状态(0表示成功,其他表示失败),suce为格式正确条数,fail为格式错误条数,msgid为状态匹配使用(如果响应的状态不是0,或者提交时needstatus不等于true,则没有msgid字段)

1.3.3    响应状态值说明

响应的值在1.2.3的基础上增加:

代码

说明

114

可用参数组个数错误(=0>1000

 

1.4   示例

http://192.168.168.168/msg/HttpPkgSM?ac=111111&pswd=123456&msg=13800000001|测试短信1&msg=13800000002|测试短信2&msg=13800000003|测试短信3&needstatus=true&product=99999&extno=123

商务合作 客服一
技术支持 客服二
在线咨询 客服二
服务咨询

133-01073265

工作时间

全天24小时服务