SDK API 点击图片下载相关案例代码

返回String格式的接口

1. 引言

1.1 目的
    该接口手册编写目的在于描述企业信息系统(以下简称EMS)具体的接口协议,供接口用户进行接口的对接开发。
    备注:提供两种编码接口,对接方根据程序编码情况选择不同的编码接口。

2. 短信

2.1 HTTP接口

  2.1.1 短息发送
  功能 : 短信发送
  GBK编码地址 : http://api.smstcby.com/smsGBK.aspx?action=Send
  UTF8编码地址 : http://api.smstcby.com/smsUTF8.aspx?action=Send
  支持GET和POST.
  备注 : 建议采用post方法提交请求,可以支持单条和批量发送
  请求参数如下 :

参数名称 描述 字段值
username 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空(密码为MD5加密码)
gwid 网关ID  由系统开户设置,系统配置,不允许为空( 联系客服
mobile 手机号码  String 不允许为空。多条手机号码,用英文逗号(,)
间隔建议最多40000个号码
message 短信内容  String 不允许为空。如果采用Get方式提交内容,请用UrlEncode把发送内容编码一下,如果采用Post方式提交内容不需要编码。短信内容最多350个字

调用返回结果:

以JOSN形式返回{"CODE":"-1","RESULT":"账户名错误"},具体错误信息具体判断

GET示例(直接输入到IE浏览器地址栏中):
http://api.smstcby.com/smsGBK.aspx?action=Send&username=*****&password=*****&gwid=***&mobile=手机号1,手机号2,手机号3&message=【签名】短信内容

1. 发送返回代码定义

返回值 错误描述
1  发送短信成功(其他请求代表成功)
-1  账号无效或未开户
-2  账号密码错误
-3  下发手机号为空
-4  下发短信内容为空
-5  指定短信网关ID为空
-6  账户或密码错误
-7  账户被冻结
-8  下发短信内容包含非法关键词
-9  账户没有充值或指定企业ID错误
-10  下发短信内容长度超出规定限制,限制为300字符
-11  下发账号余额不足
-20  服务器连接异常
-21  当前短信隶属106营销短信 必须加“尊称”、“退订回复T”
-22  数据未响应
-99 系统未知错误

  2.1.2 查询余额
  功能 : 查询余额
  地址 : http://api.smstcby.com/smsGBK.aspx?action=Get&username=******&password=*****&gwid=***

接口详细参数描述 :

参数名称 描述 字段值
username 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空(密码为MD5加密码)
gwid 网关ID  由系统开户设置,系统配置,不允许为空

返回结果以数字形式返回

1. 查询返回代码定义

返回值 错误描述
大于等于0  查询成功,并发回剩余条数
-1  账户为空
-2  密码为空
-3  网关ID为空( 联系客服
-1  没有可用的企业ID号

  2.1.3 短信回复获取
  功能 : 短信回复获取
  方式 : http get
  地址 : http://api.smstcby.com/callApi.aspx?action=query&username=******&password=*****

接口详细参数描述 :

参数名称 描述 字段值
username 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空(密码为MD5加密码)

  2.1.4 屏蔽词检测
  功能 : 屏蔽词检测
  方式 : http get
  地址 : http://api.smstcby.com/CheckWord.aspx?action=checkkeyword&username=******&password=*****&message=********

接口详细参数描述 :

参数名称 描述 字段值
username 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空(密码为MD5加密码)
message 要发送的内容  String