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

HTTP接口调用说明上海建周信息科技HTTP接口调用说明郑重声明1. 禁止相同的内容多个手机号连续一条一条提交,请连接号码使用群发方法提交, 否则禁用帐号，由此带来损失由客户自行负责.2.所有帐号提交短信，必须等上一批提交返回后再提交下一批(禁止使用多线程)官网：敏感字查询页面/key/index.html注意事项：1.短信内容中的中文字符统一采用utf-8编码。2.返回结果为纯文本方式。3.发送短信和个性化短信提交必须为POST方式4.所有输入参数都大小写敏感.5.任何单一帐号在没余额情况下仍继续提交，超过10次后，服务器会自动封该帐号发送服务器IP，既提交短信后没有任何返回值,该帐号充值后会自动解封6.所有入口地址和参数大小写敏感发送普通短信入口地址：/JianzhouSMSWSServer/http/sendBatchMessage参数说明：参数长度（字节）说明account帐号发送消息的账号password密码账号对应的登录密码destmobile目标号码目标号码,号码与号码之间用 英文; 号分割。msgText内容需要发送的短信内容。 采用UTF-8编码。 sendDateTime定时日期格式如20130201120000,14位长度,如即时发送,请留空该参数返回结果：返回值解释大于0任务ID-1余额不足-2帐号或密码错误-3连接服务商失败-4超时-5其他错误-6短信内容为空-7目标号码为空-8用户通道设置不对，需要设置三个通道-9捕获未知异常-10超过最大定时时间限制-11目标号码在黑名单里-12消息内容包含禁用词语-13没有权限使用该网关-14找不到对应的Channel ID-17没有提交权限-18提交参数名称不正确或确实参数-19必须为POST提交-20超速提交(一般为每秒一次提交)发送个性化短信入口地址：/JianzhouSMSWSServer/http/sendPersonalMessages参数说明：参数名称类型说明accountstring企业的登录账号passwordstring账号对应的密码destMobilesstring目标手机号，1.多个手机号码用|分割2.建议一次提交1000左右的号码msgContentsstring短消息内容,多个内容用|分隔, UTF-8编码号码和内容|分隔数量必须相等相同内容禁止使用此方法，请使用sendBatchMessage方法返回值解释大于0任务ID-1余额不足-2帐号或密码错误-3连接服务商失败-4超时-5其他错误-6短信内容为空-7目标号码为空-8用户通道设置不对，需要设置三个通道-9捕获未知异常-10超过最大定时时间限制-11目标号码在黑名单里-12消息内容包含禁用词语-13没有权限使用该网关-15个性化号码数量和内容数量不一致-14找不到对应的Channel ID-17没有提交权限-18提交参数名称不正确或确实参数-19必须为POST提交-20超速提交(一般为每秒一次提交)验证用户密码入口地址：/JianzhouSMSWSServer/http/validateUser参数说明：参数名称类型说明accountstring企业的登录账号passwordstring账号对应的密码返回值返回值解释1身份正确0非法用户其它值处理失败修改密码入口地址：/JianzhouSMSWSServer/http/modifyPassword参数说明：参数名称类型说明accountstring企业的登录账号oldPasswordstring账号对应的密码newPasswordstring账号对应的新密码返回值返回值解释1身份正确0处理失败，可能是用户不存在或者密码错误其它值处理失败获取余额等用户基本信息入口地址：/JianzhouSMSWSServer/http/getUserInfo参数说明：参数名称类型说明accountstring企业的登录账号passwordstring账号对应的密码备注：输出的xml字符串格式59接受上行回复1， 主动抓取 ，见 getReceivedMsg方法，时间间隔不能小于60秒2， 我方推送，推送方式为POST，编码为utf-8，接收方提供公网接受地址, 接收方返回1为接收成功。主动推送只推送1次，如接收方服务器异常或者网络问题，请使用客户端一次性接收未成功推送的上行mo。如回复及时性要求较高，请使用此方法。接收参数如下:参数名称类型说明phonestring上行回复号码contentstring回复内容，编码为utf-8timestring上行时间getReceivedMsg方法入口地址：/JianzhouSMSWSServer/http/getReceivedMsg参数说明：参数名称类型说明accountstring企业的登录账号passwordstring账号对应的密码返回值返回值解释空表示接受失败或者无上行短信非空表示成功 如有多条回复短信,每条回复用 “ | ”号分隔1356468269