功能 : 短信发送
UTF8编码地址 : http://api.duanxin.com/
支持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格式 |