短信接口(Http协议)

消息收发接口规范(HTTP方式)一开发前请阅读.............................................................................................................................21.1安全信息责任条款.......................................................................................................2二概述.............................................................................................................................................3三名词定义.....................................................................................................................................3四HTTP方法..................................................................................................................................34.1下行接口(z_mdsmssend)....................................................................................................34.2上行接口.............................................................................................................................34.3查询余额接口(z_balance)..................................................................................................4五下行返回状态.............................................................................................................................4六服务地址.....................................................................................................................................5七郑重声明.....................................................................................................................................5版本:V1.1时间:2011年12月15日一开发前请阅读1.1安全信息责任条款本人/本公司在使用本软件过程中，将严格遵守国家相关法律、法规、保证本公司信息发布的安全，并切实做到：（1）建立健全本公司信息发布的内部保障制度、信息安全保密制度、用户信息安全管理制度，建立健全本公司信息安全责任制度和信息发布的审批制度，严格审查本公司产品所发布信息。（2）严格遵守《互联网信息服务管理办法》，对用户编辑的信息内容进行把关，保证信息内容的健康、合法。（3）明确本企业的客户群和客户范围，所有通讯受众必须是自愿且明确同意接受企业服务。（4）若发送未经用户允许的信息等所造成的影响、投诉等一切损失与本软件版权方无关、由本人/本公司承担全部责任；同时，本人/本公司也应承担若因此给本软件版权方造成的全部损失。（5）不利用本软件制作、复制、发布、传播含有下列内容的信息：反对宪法所确定的基本原则的；危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的；损坏国家荣誉和利益的；煽动民族仇恨、民族歧视，破坏民族团结的；破坏国家民族宗教政策，宣扬邪教和封建迷信的；散布谣言，扰乱社会秩序，破坏社会稳定的；散布淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪的；侮辱或者诽谤他人，侵害他人合法权益的；含有法律、行政法规禁止的其他内容的；（6）自信息发布六个月内不修改删除信息发送日志内容，日志记录的备份应至少保持6个月以上，在国家机关进行依法查询时，予以提供。（7）若发现本公司所发布的信息明显属于上述第（5）款所列内容，保证立即停止传输，并向国家有关机关报告。（8）对本公司所发布的信息一时难以辨别是否属于以上所列内容之一的，应报相关主管部门审核同意后再发布。（9）对客户的个人信息保密，未经客户同意不得向他人泄漏，但法律规定的除外。本人/本公司保证：在使用本软件进行信息发布活动中，服从监督和管理；若未做到上述一至八条，本人/本公司愿意承担由此引起的一切法律责任，并接受相应的处罚。二概述本接口规范定义了短信平台（服务方）与客户系统（客户方）之间的数据传输协议及使用方法。通过这个接口规范可以实现客户系统与手机终端之间的消息传送。三名词定义名词解释下行客户通过该协议发送内容到指定号码的过程上行用户通过直接回复或者主动发送并由客户通过该协议接收的过程四HTTP方法4.1下行接口(z_mdsmssend)参数名参数说明是否必须备注sn软件序列号是由服务方提供pwd软件密码是由服务方提供(格式:MD5(sn+password))32位大写mobile发送手机号是目标号码多个半角逗号隔开content发送内容是内容长度=500字符GB2312ext子号否默认空,非空需要开放权限rrid唯一标识否空返回系统默认非空返回rrid保证唯一Stime定时时间否空实时发送非空定时格式2011-8-2213:37:354.2上行接口请客户方自行提供url,服务方将上行数据Push到该url形如:=%XXX%%XXX%格式如下:moID，特服号，手机号，内容（对内容进行gb2312解码），时间，如有多条以英文“;”4464020,62891,138****065,ceshi01,2009-10-1915:51:05;4464023,62891,139****404,test02,2009-10-1915:51:17参数名为args接收成功需要返回文本0即可返回其他默认推送失败推送失败:每五分钟推送一次,最多推送12次即:一个小时之后停止推送.4.3查询余额接口(z_balance)参数名参数说明是否必须备注sn软件序列号是由服务方提供如SDK-BBX-010-12345pwd软件密码是由服务方提供6位明文如123456Url为:=sn&pwd=pwd(ip和port参看服务地址)返回值为:string状态值为:-2参数不正确和-3账号密码不正确正常返回账户剩余条数五下行返回状态返回值返回值说明问题描述1没有需要取得的数据取用户回复就出现1的返回值,表示没有回复数据-2帐号/密码不正确1.序列号未注册2.密码加密不正确3.密码已被修改-4余额不足直接调用查询看是否余额为0或不足-5数据格式错误-6参数有误看参数传的是否均正常,请调试程序查看各参数-7权限受限该序列号是否已经开通了调用该方法的权限-8流量控制错误-9扩展码权限错误该序列号是否已经开通了扩展子号的权限-10内容长度长短信内容过长检查是否超过500字-11内部数据库错误系统错误如果长时间返回该项请联系服务方-12序列号状态错误序列号是否被禁用-13没有提交增值内容在提交彩信、语言、传真时内容为空会出现-14服务器写文件失败服务器忙（请稍后在提交）-15文件内容base64编码错误如在提交彩信时的base64编码串不正确-17没有权限如彩信发送仅限于SDK3接口-18需等待上次的提交返回默认不支持多线程提交.-19禁止同时使用多个接口地址每个序列号提交只能使用一个接口地址即SDK服务器-20提交过多禁止一个手机号相同内容连续提交限制20次内-21Ip鉴权失败使用绑定以外的ip地址提交默认不绑定六服务地址://sdk2.entinfo.cn/z_balance.aspxget方式:发送短信:=SDK-XXX-XXX-XXXXX&pwd=MD5(SN+PWD)&mobile=15201692834&content=您好,短信测试&ext=&rrid=&stime=查询余额:=SDK-XXX-XXX-XXXXX&pwd=123456以上方法Get、Post皆可七郑重声明1.禁止相同的内容多个手机号连续一条一条提交.否则禁用帐号，由此带来损失由客户自行负责.2.所有帐号提交短信，必须提交到同一个服务器3.所有帐号提交短信，必须等上一批提交返回后再提交下一批4.请客户提供外网服务器IP以便于绑定IP发送，提高账号的安全性！