您当前的位置:首页 >> 文章中心 >> 技术分享

洪度阳晨普通短信发送接口

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

1.1   接口地址

http://IP:PORT/msg/HttpBatchSendSM。

注:其中IP:PORT为服务部署的地址和端口。

1.2   参数定义


序号

参数

说明

1

ac

必填参数。用户账号

2

ts

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

3

pswd

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

4

mobile

必填参数。合法的手机号码,号码间用英文逗号分隔。最大50000个号码

5

msg

必填参数。短信内容,长度不能超过700个字符。使用URL方式编码为UTF-8格式。短信内容超过70个字符时,会被拆分成多条,然后以长短信的格式发送。

6

needstatus

可选参数。是否需要状态报告,填true表示需要状态报告;不填或者填其他值表示不需要状态报告

7

product

可选参数。用户订购的产品id,不填写时使用用户的默认产品,用户订购多个产品时必填,否则会发生计费错误。

8

extno

可选参数,扩展码,用户自定义扩展码

9

resptype

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

1.3   短信提交响应

用户短信通过http请求提交到服务器后,服务器返回响应

1.3.1    文本格式说明

格式如下

resptime,respstatus

msgid

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

Ø  提交成功

20110725160412,0

1234567890100

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

Ø  提交失败

20110725160412,101

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

1.3.2    JSON格式说明

{

      "ts": "20110725160412",

      "result": 0,

      "msgid": "1234567890100"

}

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

1.3.3    响应状态值说明

代码

说明

0

提交成功

101

无此用户

102

密码错

103

提交过快(提交速度超过流速限制)

104

系统忙(因平台侧原因,暂时无法处理提交的短信)

105

敏感短信(短信内容包含敏感词)

106

消息长度错(>700<=0

107

包含错误的手机号码

108

手机号码个数错(>50000<=0

109

无发送额度(该用户可用短信条数为0

110

不在发送时间内

111

超出该账户当月发送额度限制

112

无此产品,用户没有订购该产品

113

extno格式错(非数字或者长度不对)

115

自动审核驳回

116

签名不合法,未带签名(用户必须带签名的前提下)

117

IP地址认证错,请求调用的IP地址不是系统登记的IP地址

118

用户没有相应的发送权限

119

用户已过期

120

内容不在白名单模板中

1.4   注意事项

用户群发短信如果有审核的限制,则客户的短信必须经过管理人员的审核,审核通过后才能被提交到行业网关进行短信实际发送。

1.5   短信发送例子

http://192.168.168.168/msg/HttpBatchSendSM?ac=test01&pswd=123456&mobile=18900000000,13800138000&msg=test&needstatus=true&product=274463133

其中的IP地址192.l68.168.168需要根据系统部署的实际地址填写。

洪度阳晨JAVA示例接口案例

洪度阳晨JA...

     API使用说明       public static String send(String uri, String ac, String pswd,String ...

洪度阳晨短信平台查询状态报告接口

洪度阳晨短信...

用户通过接口查询状态报告和上行短信,查询频率建议3-5秒一次。 返回格式为JSON格式,内容包含0条或多条状态报告和上行短信 1.1   接口地址http...

洪度阳晨额度查询接口

洪度阳晨额度...

1.1   接口地址http://IP:PORT/msg/QueryBalance1.2   参数定义 序号 参数 说明

洪度阳晨短信接收接口

洪度阳晨短信...

1.1   参数定义序号 参数 说明 1 receiver

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

133-01073265

工作时间

全天24小时服务