074期一波中特|长期免费半波中特
 
 您在这里:文档首页 - 接口文档

接口说明

用户在遵循 HTTP协议的前提下,可通过GET和POST方式提交短信发送请求

短信提交地址
短信可以提交不超过 5000个手机号码,每个号码用英文逗号间隔。 (一次提交发送超过200个手机号码,请使用POST请求)

URL 地址为:

     http://116.62.212.142/msg/HttpBatchSendSM (群发接口)

     http://116.62.212.142/msg/HttpSendSM (单发接口)

?#38382;?#23450;义

序号

?#38382;?

说明

1

account

必填?#38382;?#29992;户账号

2

ts

可选?#38382;?#26102;间戳,格式 yyyyMMddHHmmss

3

pswd

必填?#38382;?#29992;户密码, ts ?#38382;?#20026;空时填明文密码, ts ?#38382;?#19981;为空时填 md5 ( 账号 + 密码 + 时间戳 ) ,对账号密码时间戳拼接的?#22336;?#20018;进行 md5 ?#29992;?

4

mobile

必填?#38382;?#21512;法的手机号码,号码间用英文逗号?#25351;?

5

msg

必填?#38382;?#30701;信内容,长度不能超过 700 个?#22336;?#20351;用 URL 方式编码为 UTF-8 格式。短信内容超过 70 个?#22336;?#26102;,会被拆分成多条,然后以长短信的格式发送。 内容格式:内容【自定义签名】

6

needstatus

必填?#38382;?#26159;否需要状态报告,取值 true 或 false , true ,表明需要状态报告; false 不需要状态报告

7

product

可选?#38382;?#29992;户订购的产品 id ,不填写时使用用户的默认产品,用户订购多个产品时必填,否则会发生?#21697;?#38169;误。

8

extno

可选?#38382;?#25193;展码,用户自定义扩展码

9

resptype

可选?#38382;?#21709;应格式,默认返回文本格式,填 json 返回 json 格式

短信提交响应
用户短信通过 http请求提交到服务器后,服务器返回响应码,响应码的格式如下:

resptime,respstatus

msgid

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

示例
提交成功

20110725160412,0

1234567890100

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

提交失败

20110725160412,101

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

响应状态值说明

代码

说明

0

提交成功

101

无此用户

102

密码错

103

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

104

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

105

敏感短信(短信内容包含敏?#20889;剩?

106

消息长度错(>700或<=0)

107

包含错误的手机号码

108

手机号码个数错(群发>50000或<=0;单发>200或<=0)

109

无发送额度(该用户可用短信数已使用完)

110

不在发送时间内

111

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

112

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

113

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

114

可用?#38382;?#32452;个数错误(小于最小设定值或者大于1000)

115

自动审核驳回

116

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

117

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

118

用户没有相应的发送权限

119

用户已过期

120

内容不在白名单模板中


注意事项
用户群发短信如果有审?#35828;南?#21046;,则客户的短信必须经过管理人员的审核,审核通过后才能被提交到网关进行短信实际发送。
用户群发短信必须满足手机号码最低个数?#21335;?#21046;,低于系?#25104;?#23450;的群发最小手机号码数,则该提交请求会被拒绝,响应码为 108。

短信发送例子

【您的签名】您的发送内容

Ø 短信单发

http://116.62.212.142/msg/HttpSendSM?account=111111&pswd=123456&mobile=18900000000,13800138000&msg=test【自定义签名】 &needstatus=true&product=99999

Ø 短信群发

http://116.62.212.142/msg/HttpBatchSendSM?account=test01&pswd=123456&mobile=18900000000,13800138000&msg=test【自定义签名】 &needstatus=true&product=274463133

状态报告推送
如果管理员设置用户账户需要状态报告,并且也配置了账户的状态报告接收地址,则用户可以接收到其发送短信的状态报告。用户侧启动一个 HTTP服务用于接收状态报告。(使用HTTP GET方式推送状态,每?#25105;?#26465;)

?#38382;?#23450;义

序号

?#38382;?

说明

1

receiver

接收状态报告验证的用户名(不是账户名),?#21069;?#29031;用户要求配置的名称,可以为空

2

pswd

接收状态报告验证的密码,可以为空

3

msgid

提交短信时平台返回的msgid,参见 普通短信发送 - ?#38382;?#23450;义

4

reportTime

格式YYMMDDhhmm,其中YY=年份的最后两位(00-99),MM=月份(01-12),DD=日(01-31),hh=小时(00-23),mm=分钟(00-59)

5

mobile

单一的手机号码

6

status

状态报告数值

状态报告值
状态报告的值即, status后面的数据,如下

状态值(?#22336;?#20018;)

说明

MBBLACK

黑名单号码

NOROUTE

无通道

ROUTEERR

通道异常

REJECT

审核驳回

DISTURB

手机号码发送?#38382;?#36807;多

EMSERR

长短信不完整

SIGNERR

签名错

KEYWORD

敏?#20889;?

其他

网关内部状态

示例

http://pushUrl?receiver=admin&pswd=12345&msgid=12345&reportTime=1012241002&mobile=13900210021&status=DELIVRD

其中, pushUrl为用户启动的服务地址。
在收到状态报告后需要自己写个方法去做处理收到的?#38382;?

短信接收

?#38382;?#23450;义

序号

?#38382;?

说明

1

receiver

接收信息验证的用户名(不是账户名),?#21069;?#29031;用户要求配置的名称,可以为空

2

pswd

接收信息服务需验证的密码,可以为空

3

moTime

格式YYMMDDhhmm,其中YY=年份的最后两位(00-99),MM=月份(01-12),DD=日(01-31),hh=小时(00-23),mm=分钟(00-59)

4

mobile

单一的手机号码

5

msg

MO短信内容,文字内容使用UTF-8编码

6

destcode

用户上行的目的号码

7

isems

是否为长短信的一部分,1:是,0,不是。不带该?#38382;?#40664;认为普通短信

8

emshead

Isems为1时,本?#38382;?#20197;ASCII码?#38382;?#26174;示长短信的头信息。用“,”隔开,分为三个部分,第一部分标识该条长短信的ID(该ID为短信中心生成);第二部分,表明该长短信的总条数(pk_total);第三部分,该条短信为该长短信的第几条(pk_number)。 例如:234,4,1,该短信的ID为234,该长短信的总长度为4条,1,当前为第一条。

示例
普通短信:

http://pushMoUrl?receiver=admin&pswd=12345&moTime=1208212205&mobile=13800210021&msg=hello&destcode=10657109012345

其中, pushUrl为用户启动的服务地址。
在收到短信上行后需要自己写个方法去做处理收到的?#38382;?/P>

额度查询接口

接口地址

URL 地址为:

   http://116.62.212.142/msg/QueryBalance

?#38382;?#23450;义

序号

?#38382;?

说明

1

account

必填?#38382;?#29992;户账号

2

pswd

必填?#38382;?#29992;户密码

提交响应

20130303180000,0

1234567,1000

1234531,2000

第一行显示返回额度时的时间,提交响应值。
第二行开始,每一行显示一个产品 ID及其额度,有多少个产品显示多少行。

提交响应值

代码

说明

0

成功

101

无此用户

102

密码错误

103

查询过快(30秒查询一次)

示例

http://116.62.212.142/msg/QueryBalance?un=111111&pw=123456

COPYRIGHT @ 2017-2018 深圳市麦讯通科技有限公司 ALL RIGHTS RESERVED. 备案号:粤ICP备08026943号

粤公网安备 44030702001630号

?#38469;?#25903;持:百川网络
074期一波中特
福彩3d图谜总汇 cba全明星赛如何投票 上海时时彩最快开奖网 迅雷赚钱宝 上海快三形态走势图 创富坛心水论坛146 3d试机号是开417 浙江飞鱼投注 一尾中特平百分百 2010年彩票销售额 四肖中特期期准免费 内蒙古快三开奖结果查询结果 破解极速时时彩软件手机版下载 江西快三遗漏 2019六合彩33开什么