2022年短信接口 2.pdf
消息收发接口规范(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 页，共 5 页 - - - - - - - - - 一 开发前请阅读1.1安全信息责任条款本人 /本公司在使用本软件过程中，将严格遵守国家相关法律、法规、保证本公司信息发布的安全，并切实做到：（1）建立健全本公司信息发布的内部保障制度、信息安全保密制度、用户信息安全管理制度， 建立健全本公司信息安全责任制度和信息发布的审批制度，严格审查本公司产品所发布信息。（2）严格遵守互联网信息服务管理办法，对用户编辑的信息内容进行把关，保证信息内容的健康、合法。（3）明确本企业的客户群和客户范围，所有通讯受众必须是自愿且明确同意接受企业服务。（4）若发送未经用户允许的信息等所造成的影响、投诉等一切损失与本软件版权方无关、由本人/本公司承担全部责任；同时，本人/本公司也应承担若因此给本软件版权方造成的全部损失。（5）不利用本软件制作、复制、发布、传播含有下列内容的信息：反对宪法所确定的基本原则的；危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的；损坏国家荣誉和利益的；煽动民族仇恨、民族歧视，破坏民族团结的；破坏国家民族宗教政策，宣扬邪教和封建迷信的；散布谣言，扰乱社会秩序，破坏社会稳定的；散布淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪的；侮辱或者诽谤他人，侵害他人合法权益的；含有法律、行政法规禁止的其他内容的；（6）自信息发布六个月内不修改删除信息发送日志内容，日志记录的备份应至少保持 6 个月以上，在国家机关进行依法查询时，予以提供。（7）若发现本公司所发布的信息明显属于上述第（5）款所列内容，保证立即停止传输，并向国家有关机关报告。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 5 页 - - - - - - - - - （8）对本公司所发布的信息一时难以辨别是否属于以上所列内容之一的，应报相关主管部门审核同意后再发布。（9）对客户的个人信息保密，未经客户同意不得向他人泄漏，但法律规定的除外。本人 /本公司保证：在使用本软件进行信息发布活动中，服从监督和管理；若未做到上述一至八条，本人 /本公司愿意承担由此引起的一切法律责任，并接受相应的处罚。二 概述本接口规范定义了短信平台（服务方）与客户系统（客户方）之间的数据传输协议及使用方法。 通过这个接口规范可以实现客户系统与手机终端之间的消息传送。三 名词定义名词解释下行客户通过该协议发送内容到指定号码的过程上行用户通过直接回复或者主动发送并由客户通过该协议接收的过程四 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 形如 : http:/ 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 5 页 - - - - - - - - - %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=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 服务器写文件失败服务器忙（请稍后在提交）名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 5 页 - - - - - - - - - -15 文件内容base64 编码错误如在提交彩信时的base64 编码串不正确-17 没有权限如彩信发送仅限于SDK3接口-18 需等待上次的提交返回默认不支持多线程提交. -19 禁止同时使用多个接口地址每个序列号提交只能使用一个接口地址即SDK服务器-20 提交过多禁止一个手机号相同内容连续提交限制20 次内-21 Ip 鉴权失败使用绑定以外的 ip 地址提交默认不绑定六 服务地址http:/ http:/ get 方式 : 发送短信 : http:/ ,短信测试 &ext=&rrid=&stime= 查询余额 : http:/ 以上方法 Get、Post皆可七 郑重声明1.禁止相同的内容多个手机号连续一条一条提交. 否则禁用帐号，由此带来损失由客户自行负责 . 2.所有帐号提交短信，必须提交到同一个服务器3.所有帐号提交短信，必须等上一批提交返回后再提交下一批4.请客户提供外网服务器IP 以便于绑定IP 发送，提高账号的安全性！名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 5 页 - - - - - - - - -
