《E_MM7彩信协议》.doc

E_MM7系统外部接口 天津易蝶软件科技有限公司 2006－09－01 内容介绍 《E_MM7系统外部接口描述手册》针对中国移动彩信MM7协议编写,协议支持中兴,华为,爱立信接入接口规范，系统定义如何与彩信网关建立通讯和业务信息发送, 在二级网关上,系统采用中国移动中兴协议规范编写,可以作为独立的MMSC网关建立和第三方用户接入,完全支持上下行信息和状态报告转发,第三方用户可以自己开发系统,接入规范参考中国移动mm7API用户手册,只要符合上述业务规范都可以接入本系统,在业务扩展上实现同步订购接口。本手册分为以下几个章节： E_MM7系统外部接口描述手册 撰 稿： 李 绍 松 责任审阅： 修订版本 修订者 修订日期 审阅 1.0.0 李绍松 060910 目 录 1 概述 1-1 2 上行业务规范 一 2.1 彩信上行业务接口 一 2.2 接收状态报告和阅读报告 三 2.3 业务同步订购 四 2.4 WebService业务接口规范 五 2.5 下发数据库接口规范 八 2.6 下发数据归档处理 十 2.7 订购业务定时业务处理 十一 3 返回错误代码 3-1 4 FAQ问答 4-1 4.1 如何实现用户上行彩信,可以下发彩信呢 4-1 4.2 如何实现用户上行彩信,可以下发短信呢 4-1 4.3 如果使用HTTP方式获取彩信文件内容,如果实现 4-1 4.4 如果户上行彩信,文件存储在硬盘那个目录 4-1 4.5 在下发彩信的时候如何使用文件路径 4-1 4.6 在下发彩信的时候如何使用SMIL文件解析方式发送文件 4-2 4.7 如何发送multipart/related或者multipart/mixed类型的彩信息 4-2 4.8 在发送彩信过程中如果使用ContentType,contentid字段 4-3 4.9 在发送彩信过程中如何发送文本 4-3 概述 E_MM7系统基于中国移动MM7协议，MM7协议采用HTTP+XML+MIME(邮件格式) 在HTTP协议上采用HEAD+POST方法,通讯过程中可以采用长连接方式或者短连接方式,在与彩信网关通讯过程中可以建立多条连接实现发送,每条信息单元通过transactionid交易表示确认唯一消息,在消息重发机制上,自动建立通讯连路,直到信息正确提交到网关. 二级网关功能,系统按照中国移动MM7协议规范,在系统上集成二级网关接入规范,通讯协议单元完全遵循中国移动MM7协议规范,支持彩信上行,状态报告,阅读报告转发,下行数据发送,在二级网关管理上,系统提供了第三方用户在线开户,停止,恢复,删除功能,发送流量控制,流量监控,通讯协议单元分析,过滤等可视管理功能 订购业务同步处理,系统提供了订购同步数据转发功能,可以实现第三方用户订购的同步订阅,如果第三方同步接口同步失败,将返回给移动用户订购失败,达到同步订阅能力. 作业处理 系统在作业管理上采用模块处理订购业务下发,在系统维护上,可以设定任务执行精度(减少IO操作),可以设定任务源和订购用户数据源,在发送上可以控制线程数量和速度及其下发号码打包数量. 非数据库业务接口,系统提供了SOAP业务接口方式,可以实现WebService接入,在业务处理上统一业务接口,实现彩信发送. 数据库业务接口,在数据发送上,系统提供了下发表方式,将彩信内容写入定义好的表中,实现彩信发送,业务接口相对简单 日志管理系统在日志处理上,采用内存缓冲,只有当缓冲区满后,才写入日志表 协议分析,系统体统了强大的网络协议分析,用户可以在任何时间观察网络协议包. 上行业务规范 彩信上行业务接口 下面为用户上行一条彩信,在系统中的处理顺序流程 在系统处理过程,首先磁盘文件-数据库存储文件-数据库通知上行彩信息-http上行分发-第三方转发. 第一步:写入系统指定的上行彩信媒体存放目录中,文件的存放方式由文件类型进行分类,image图片目录,txt文本目录,audio铃声目录,video视频目录,smil目录,others其它无法识别类型文件 第二步:调用MMS_MODeliveryContent数据库接口存储过程,将接收到的彩信文件内容和名字通过此接口存储到数据库中 (默认表MMS_RecvDetailInfo),用户可以选择存储文件到数据库中或者不存储,只保存文件名称,参数定义如下 @Date --接收时间 @TransactionID --交易表识别,也是上行唯一数据标识 @FileName --文件名称 @ContentType --媒体类型 @ContentBi