短信接口(Http协议).docVIP

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