功能 : 短信发送
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位数。 |
调用返回结果:
以XML形式返回;具体错误信息具体判断
status ---------- 返回状态值:成功返回Success 失败返回:Faildmessage ---------- 返回信息:见下表remainpoint ---------- 返回余额taskID ----------- 返回本次任务的序列IDsuccessCounts --成功短信数:当成功后返回提交成功短信数
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 不允许为空,用户账号对应的密码 |
发送成功返回值
1. 查询返回代码定义status -------返回状态值:成功返回Success 失败返回:Faildmessage --------------返回信息提示:见下表payinfo --------------返回支付方式 后付费,预付费overage -------------返回余额sendTotal ----返回总点数 当支付方式为预付费是返回总充值点数
返回值 | 错误描述 |
返回空 | "查询成功,将返回相应的支付方式、账户使用条数、总充值点数" |
用户名或密码不能为空 | 提交的用户名或密码为空 |
用户名或密码错误 | 表示用户名或密码错误 |
功能 : 短信回复获取
方式 : 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 不允许为空,需要发送的内容 |