文档中心
代码示例

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

参数名称 描述 字段值
type 操作类型  String 不允许为空
username 账户名  String 不允许为空
password 账户密码  不允许为空账户密码,密码必须MD5加密并且取32位大写
gwid 企业编码  String 不允许为空企业编码,代表网关通道类型。
mobile 手机号码  String 不允许为空多个手机号码,用英文逗号(,)建议单次提交最多50000个号码
message 下发短信内容  String 不允许为空下发短信内容
dstime 定时要发送的时间  String 可为空 定时要发送的时间,精确到秒(yyyy-MM-dd HH:mm:ss)
rece 返回格式选择  String 可为空 返回格式选择rece=json 返回为json格式数据 rece=xml 返回格式为 xml信息 默认是返回XML格式

调用返回结果:

以JOSN形式返回{"returnstatus":"success","code":"0","taskID":"2011020205050454854"}";具体错误信息具体判断

GET示例(直接输入到IE浏览器地址栏中):
http://jk.smstcby.com/smsGBK.aspx?type=send&username=*****&password=*****&gwid=***&mobile=手机号1,手机号2,手机号3&message=【天蓝蓝】您的验证码是:23241&rece=json

1. 发送返回代码定义

返回值 错误描述
0  发送短信成功(其他请求代表成功)
-1  账号无效或未开户
-2  账号密码错误
-3  账户不存在
-4  账户密码错误
-5  发送手机号码为空
-6  发送短信内容为空
-7  短信签名为空
-8  手机号码格式错误
-9  短信内容仅能包含一个【】这种符号,请用其它符号代替
-10  指定网关ID错误
-11   账户余额不足
-20  不存在应用签名或者签名为审核,请登录平台查看
-21  定时发送时间格式化错误
-22  短信下发格式错误,正确格式:【签名】+短信内容,签名符号【】 只能出现一次!
-99 未知异常

  功能 : 查询余额
  地址 : http://jk.smstcby.com/smsGBK.aspx?type=overage&username=*****&password=*****&&gwid=***&rece=json

接口详细参数描述 :

参数名称 描述 字段值
type 操作类型  String 不允许为空,overage
username 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空(密码为MD5加密码)
gwid 网关ID  由系统开户设置,系统配置,不允许为空
rece 返回格式选择  String 可为空 返回格式选择rece=json 返回为json格式数据 rece=xml 返回格式为 xml信息 默认是返回XML格式

发送成功返回值(json 类型字符串) {"returnstatus":"success","code":"0","overage":"10855"}

1. 查询返回代码定义

返回值 错误描述
0  查询成功,并发回剩余条数
-1  账户为空
-2  账户密码错误
-3  账户不存在( 联系客服
-4  账户密码错误

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

接口详细参数描述 :

参数名称 描述 字段值
type 操作类型  String 不允许为空, query
username 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空(密码为MD5加密码)
rece 返回格式选择  String 可为空 返回格式选择rece=json 返回为json格式数据 rece=xml 返回格式为 xml信息 默认是返回XML格式

响应报文: 获取成功 {"total":"2","list":[ { "taskid": "20101111111111", "mobile": "15122222222", "content": "T", "receivetime": "2010-02-13 13:00:48.05" }, { "taskid": "2010111111111111", "mobile": "15122222222", "content": "T", "receivetime": "2010-02-13 13:02:15.073" } ]} 获取失败 {"returnstatus":"error","code":"-4","remark":"账户密码错误!"}

  2.1.4 屏蔽词检测
  功能 : 屏蔽词检测
  方式 : http get
  地址 http://jk.smstcby.com/checkWord.aspx?type=checkkeyword&username=*****&password=*****gwid=*****&message=********&rece=json

接口详细参数描述 :

type 操作类型  String 不允许为空, checkkeyword
参数名称 描述 字段值
username 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空(密码为MD5加密码)
message 要发送的内容(默认是UTF8 格式)  String
rece 返回格式选择  String 可为空 返回格式选择rece=json 返回为json格式数据 rece=xml 返回格式为 xml信息 默认是返回XML格式