0769-33860681
banner2

开发软件

当前位置:短信猫网站主页 > 开发软件 >

企业短信通网关通道HTTP接口

发布时间:2017/02/09 点击量:

企业短信通HTTP接口调用说明
                    

目录
 
接口设计 3
1.1.1. 发送普通短信 3
1.1.2. 接收状态报告 4
1.1.3. 接收短信 5
1.1.4. 查询余额 6
 

接口设计

1.1.1. 发送普通短信

企业短信通发送普通短信。
入口地址:http://www.112088.net:8088/sendsms_txt.asp
说明:该接口可以发送单条短信和发送多条短信。
特别说明:为解决最快速度将数据传达至本发送平台,本平台域名www.112088.net为双向空间域名,如果你是电信线路,则会自动跳到电信IP:116.204.97.93,如果你网通线路则会自动跳到网通线跳:211.162.126.121
参数说明:
发送短信所需参数如下:
参数 长度(字节)
及描述
类型 说明
us_name 用户名 字符串 发送消息的企业账号
us_pwd 用户密码 字符串 账号对应的登录密码
send_phone 发送的目标号码 字符串 目标号码,小灵通需加区号,移动,联通,电信cdma则为手机号码。
如:075580808080,13512345678,13012345678
可以发送多个号码,每个号码用英文,号(逗号)分开,最大允许每次提交号码100个号码
send_content 发送的短信内容 字符串 需要发送的短信内容。 70字为一条标准的短信,大于70字则按长短信标准计算条数。
send_time 发送时间
(不带此参数,表示即时短信)
可选参数
字符串 可以实现定时短信,格式必须为14个数字,如2010年9月3日上午11点20分30秒,表示为:20100903112030
 
返回结果:
含义
-1 缺少接收的目标号码
-2 缺少短信内容
-3|禁发词 短信内容非法,含有禁发关键词,具体的禁发词在单竖线的后一个值体现
-4 每次请求条数大于最大允许条数100条
-7 用户登入信息验证失败(一般为密码错误)
-8 短信内容长度超过规定最大字符长度335个字符
-9 帐户当前余额不足发送本次请求的条数
-10 帐号已被锁定
-99 系统忙,无法受理此次请求
0|a|b|d 提交短信成功。
以单竖线分开每项值,具体说明如下:
第一项值:0 ;表示本次请求已被服务器成功受理;
第二项值:a ;表示本次请求已经被成功受理的短信号码个数,主要为有效
号码,受理成功后会立即提交到网关进行发送。
第三项值:b ;表示处理失败的号码个数,一般为号码长度不对等。
第三项值:b ;表示处理失败的号码个数,一般为号码长度不对等。
第四项值:d ;返回本次提交到网关的短信批次编号,以方便在收取状态报告时相对应批次,然后再对应号码。
每个SMSID用英文逗号分开,SMSID的个数是本次提交成功的号码数。
 
调用接口示例:
http://www.112088.net:8088/sendsms_txt.asp?us_name=帐号&us_pwd=密码&send_phone=发送号码&send_content=短信内容
具体示例:
http://www.112088.net:8088/sendsms_txt.asp?us_name=mysms&us_pwd=123456&send_phone=13798361236&send_content=这条是测试短信
返回正确的结果的返回值为:0|1|0|SMSID
 
可以一次发送多条,发送的号码以用英文,号(逗号)分开,每次提交最大不能超过100条。
 
 
 
 

1.1.2. 接收状态报告

接收当前已经发送了的短信的状态报告。
入口地址:
接收本账号的状态报告http://www.112088.net:8088/get_report_txt.asp

参数说明:
参数 长度(字节) 类型 说明
us_name 用户名 字符串 发送消息的企业账号
us_pwd 用户密码 字符串 账号对应的登录密码

返回结果:
含义
0 成功,表示目前没有状态报告返回
-1 用户不存在
-3 系统忙,请稍候再试
-7 帐号登录验证失败
 
长字符串形式返回(最大返回100条):
以竖线“|”返回各状态报告,第一个竖线之前为状态报告数量,如果没有状态报告则返回0,
接着是短信批次编号+”;”+本批次中发送的号码+”;”+具体的状态报告值。加“|”+下一个状态报告消息。
信息编号和号码及状态报告值之间用分号分割。
每条状态格式为:短信批次编号+”;”+本批次中发送的号码+”;”+具体的状态报告值。
(状态报告值为整数,分别表示的含义为:-1-- 未收到状态报告;10-发送成功;20-发送失败)
 
调用接口示例:
http://www.112088.net:8088/get_report_txt.asp?us_name=帐号&us_pwd=密码
-------------------------------------------------------
3|6408676;13682250950;20|6408649;13711147169;20|6408649;13719445093;20
-------------------------------------------------------
当客户端向服务端发起收取状态报告请求之后,服务端将自动修改返回smsid的标识,认为客户端已经获取了返回的smsid的结果,服务端将不再分发此SMSID的状态报告信息编号的结果给客户端,以免造成客户端重复收取。
 
 
 
 

1.1.3. 接收短信

接收当前收到的短消息。
入口地址:
接收本账号的状态报告http://www.112088.net:8088/get_receive_message_txt.asp

参数说明:
参数 长度(字节) 类型 说明
us_name 用户名 字符串 发送消息的企业账号
us_pwd 用户密码 字符串 账号对应的登录密码
 
返回结果:
含义
0 成功,表示当前没有新的短消息上行。
-1 用户不存在
-3 系统忙,请稍候再试
-7 帐号登录验证失败
 
长字符串形式返回(最大返回50条):
以竖线“|”返回各接收到的每条短信,第一个竖线之前表示接收到的短信总数,如果没有新短信则返回0,接着是 短信编号+”;”+发送者的电话号码+”;”+接收到的具体内容+”|”+下一条短信。
短信编号和发送者的电话号码和接收到的具体内容 各值之间用分号分开。
每条短信格式为:短信编号+”;”+发送者的电话号码+”;”+接收到的具体内容。
 
 
 
调用接口示例:
http://www.112088.net:8088/get_receive_message_txt.asp?us_name=帐号&us_pwd=密码
-------------------------------------------------------
2|133,13798361236;我回复一条|134,13826588212;我也回复一条-------------------------------------------------------
当客户端向服务端发起收取短信请求之后,服务端将自动修改返回短信编号的标识,认为客户端已经获取了返回的短信编号的结果,服务端将不再分发此短信编号的内容给客户端,以免造成客户端重复收取。
 
 
 

1.1.4. 查询余额

查询帐户余额。
入口地址:http://www.112088.net:8088/Get_Account_Balance.asp
说明:该接口用查询用户当前可用条数,返回等于或是大于0的字符串。
参数说明:
1. 查询可用条数所需参数如下:
参数 长度(字节) 类型 说明
us_name 用户名 字符串 发送消息的企业账号
us_pwd 用户密码 字符串 账号对应的登录密码
 
返回结果:
含义
-1 帐户不存在
-7 用户登入信息验证失败
0 当前可用条数为0
其它 当前可用条数
 
调用接口示例:
http://www.112088.net:8088/Get_Account_Balance.asp?us_name=帐号&us_pwd=密码
返回正确的结果会返回值为:条数
 
 
附件:《企业短信通HTTP接口调用说明文档.pdf

地址:广东省深圳市龙华区   电话:0755-36537765   
Copyright © 2008-2016 WAVECOMCN.COM 深圳市昌隆通泰科技有限公司 版权所有 Power by DedeCms
ICP备案编号:粤ICP备15095438号