建周短信平台http接口说明文档

更新时间:2024-01-11 02:45:01 阅读量: 教育文库 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

上海建周信息科技 HTTP接口调用说明

郑重声明

1. 禁止相同的内容多个手机号连续一条一条提交,请连接号码使用群发方法提交, 否则禁用帐号,由此带来损失由客户自行负责.

2.所有帐号提交短信,必须等上一批提交返回后再提交下一批(禁止使用多线程)

官网:www.shjianzhou.com

敏感字查询页面

http://www.shjianzhou.com/key/index.html

注意事项:

1.短信内容中的中文字符统一采用utf-8编码。 2.返回结果为纯文本方式。

3.发送短信和个性化短信提交必须为POST方式 4.所有输入参数都大小写敏感.

5.任何单一帐号在没余额情况下仍继续提交,超过10次后,服务器会自动封该帐号发送服务器IP,既提交短信后没有任何返回值,该帐号充值后会自动解封 6.所有入口地址和参数大小写敏感

发送普通短信

入口地址:http://www.jianzhou.sh.cn/JianzhouSMSWSServer/http/sendBatchMessage 参数说明:

参数 account password destmobile 长度(字节) 帐号 密码 目标号码 发送消息的账号 账号对应的登录密码 目标号码,号码与号码之间用 英文; 号分割。 说明 HTTP接口调用说明

msgText sendDateTime

返回结果: 返回值 大于0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -17 -18 -19 -20 内容 定时日期 需要发送的短信内容。 采用UTF-8编码。 格式如20130201120000,14位长度,如即时发送,请留空该参数 解释 任务ID 余额不足 帐号或密码错误 连接服务商失败 超时 其他错误 短信内容为空 目标号码为空 用户通道设置不对,需要设置三个通道 捕获未知异常 超过最大定时时间限制 目标号码在黑名单里 消息内容包含禁用词语 没有权限使用该网关 找不到对应的Channel ID 没有提交权限 提交参数名称不正确或确实参数 必须为POST提交 超速提交(一般为每秒一次提交) 发送个性化短信

入口地址:http://www.jianzhou.sh.cn/JianzhouSMSWSServer/http/sendPersonalMessages 参数说明: 参数名称 account password destMobiles 类型 string string string 说明 企业的登录账号 账号对应的密码 目标手机号, 1.多个手机号码用||分割 2.建议一次提交1000左右的号码 短消息内容,多个内容用||分隔, UTF-8编码 号码和内容||分隔数量必须相等 相同内容禁止使用此方法,请使用sendBatchMessage方法 解释 版权所有 侵权必究 第 1 页 共 5 页

msgContents string 返回值 HTTP接口调用说明

大于0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -15 -14 -17 -18 -19 -20

任务ID 余额不足 帐号或密码错误 连接服务商失败 超时 其他错误 短信内容为空 目标号码为空 用户通道设置不对,需要设置三个通道 捕获未知异常 超过最大定时时间限制 目标号码在黑名单里 消息内容包含禁用词语 没有权限使用该网关 个性化号码数量和内容数量不一致 找不到对应的Channel ID 没有提交权限 提交参数名称不正确或确实参数 必须为POST提交 超速提交(一般为每秒一次提交) 验证用户密码

入口地址:http://www.jianzhou.sh.cn/JianzhouSMSWSServer/http/validateUser 参数说明: 参数名称 account password 返回值 返回值 1 0 其它值

解释 身份正确 非法用户 处理失败 类型 string string 说明 企业的登录账号 账号对应的密码 修改密码

入口地址:http://www.jianzhou.sh.cn/JianzhouSMSWSServer/http/modifyPassword

版权所有 侵权必究 第 2 页 共 5 页

HTTP接口调用说明

参数说明: 参数名称 account oldPassword newPassword 返回值 返回值 1 0 其它值 解释 身份正确 处理失败,可能是用户不存在或者密码错误 处理失败 类型 string string string 说明 企业的登录账号 账号对应的密码 账号对应的新密码 获取余额等用户基本信息

入口地址:http://www.jianzhou.sh.cn/JianzhouSMSWSServer/http/getUserInfo 参数说明: 参数名称 account password 类型 string string 说明 企业的登录账号 账号对应的密码 备注:输出的xml字符串格式

59

接受上行回复

1, 主动抓取 ,见 getReceivedMsg方法,时间间隔不能小于60秒

2, 我方推送,推送方式为POST,编码为utf-8,接收方提供公网接受地址, 接收

方返回1为接收成功。主动推送只推送1次,如接收方服务器异常或者网络问题,请使用客户端一次性接收未成功推送的上行mo。 如回复及时性要求较高,请使用此方法。

接收参数如下:

版权所有 侵权必究 第 3 页 共 5 页

HTTP接口调用说明

参数名称 phone content time 类型 string string string 说明 上行回复号码 回复内容,编码为utf-8 上行时间 getReceivedMsg方法

入口地址:http://www.jianzhou.sh.cn/JianzhouSMSWSServer/http/getReceivedMsg 参数说明: 参数名称 account password 返回值 返回值 空 非空 13564682693,好,20080114140514 类型 string string 说明 企业的登录账号 账号对应的密码 解释 表示接受失败或者无上行短信 表示成功 如有多条回复短信,每条回复用 “ | ”号分隔 每条回复内容以”|”号分隔.第一为回复号码,第二为回复内容,第三个为回复日期.内容为unicode码,如\你\好\,\测\试,需转化 版权所有 侵权必究 第 4 页 共 5 页

本文来源:https://www.bwwdw.com/article/b5so.html

Top