文档中心
代码示例

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

参数名称 描述 字段值
action 操作类型  String 不允许为空
userid 企业ID  String 不允许为空,企业唯一的数字ID
account 账户名  String 不允许为空
password 账户密码  不允许为空,用户账号对应的密码
mobile 手机号码  String 不允许为空,多个手机号码,用英文逗号(,)建议单次提交最多50000个号码
content 下发短信内容  String 不允许为空,下发短信内容
sendTime 定时要发送的时间  String 可为空,定时要发送的时间,精确到秒(yyyy-MM-dd HH:mm:ss)
extno 扩展子号  String 可为空,请先询问配置的通道是否支持扩展子号,如果不支持,请填空。子号只能为数字,且最多5位数。
rt 返回格式选择  String 可为空 返回格式选择rt=json 返回为json格式数据 rt=xml 返回格式为 xml信息 默认是返回XML格式

调用返回结果:

以XML形式返回;具体错误信息具体判断



status ---------- 返回状态值:成功返回Success 失败返回:Faild
message ---------- 返回信息:见下表
 remainpoint ---------- 返回余额

taskID  -----------  返回本次任务的序列ID
successCounts --成功短信数:当成功后返回提交成功短信数

						

GET示例(直接输入到IE浏览器地址栏中):
http://sms.jzsms.cn/sms.aspx?action=send&userid=12&account=账号&password=密码&mobile=15023239810&content=内容&sendTime=&extno=

1. 发送返回代码定义

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

  功能 : 查询余额
  地址 : http://sms.jzsms.cn/sms.aspx?action=overage&userid=12&account=账号&password=密码

接口详细参数描述 :

参数名称 描述 字段值
action 操作类型  String 不允许为空,overage
userid 企业ID  由系统开户设置,系统配置,不允许为空
account 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空,用户账号对应的密码
rece 返回格式选择  String 可为空 返回格式选择rece=json 返回为json格式数据 rece=xml 返回格式为 xml信息 默认是返回XML格式

发送成功返回值



status-------返回状态值:成功返回Success 失败返回:Faild
message--------------返回信息提示:见下表
payinfo--------------返回支付方式  后付费,预付费
overage-------------返回余额
sendTotal----返回总点数  当支付方式为预付费是返回总充值点数

1. 查询返回代码定义

返回值 错误描述
返回空  "查询成功,将返回相应的支付方式、账户使用条数、总充值点数"
用户名或密码不能为空  提交的用户名或密码为空
用户名或密码错误  表示用户名或密码错误

  功能 : 短信回复获取
  方式 : http get
  地址 : http://sms.jzsms.cn/callApi.aspx?action=query&userid=12&account=账号&password=密码

接口详细参数描述 :

参数名称 描述 字段值
action 操作类型  String 不允许为空, query
userid 返回格式选择  String 不允许可为空,企业ID
account 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空,用户账号对应的密码

响应报文: 获取成功

 


15023239810-------------对应的手机号码
1212-------------同一批任务ID
你好,我不需要---------上行内容
2011-12-02 22:12:11-------------接收时间


15023239811
1212
你好,本次活动路线是怎么的
2011-12-02 22:12:11


获取失败

 


1-------------错误码
用户名或密码不能为空-------------错误描述


  1:用户名或密码不能为空
  2:用户名或密码错误
  3:该用户不允许查看状态报告
  4:参数不正确

  功能 : 非法关键词查询
  方式 : http get
  地址 : http://sms.jzsms.cn/sms.aspx?action=checkkeyword&userid=12&account=账号&password=密码&content=内容

接口详细参数描述 :

参数名称 描述 字段值
action 操作类型  String 不允许为空, 设置为固定的:checkkeyword
userid 企业ID  String 不允许为空, 企业ID
account 用户名  String 不允许为空,系统开户设置
password 密码  String 不允许为空,用户账号对应的密码
message 检测发送内容  String 不允许为空,需要发送的内容