《数据业务管理平台接口规范-SP分册.docx》由会员分享，可在线阅读，更多相关《数据业务管理平台接口规范-SP分册.docx（28页珍藏版）》请在三一办公上搜索。
1、中国移动通信集团公司 发布QB-GF-003-2003中国移动通信企业标准移动数据业务管理平台(DSMP)接口规范Mobile Data Service Management Platform Interface Specification 版本号：1.5.0 2003-1-31实施2003-1-31发布目 录前 言III1 适用范围12 引用标准23 相关术语与缩略语解释44接口命名规范55 接口在网络中的位置66系统接口描述76.1 DSMP对外接口描述76.2接口消息实现87 字段类型说明88 DSMP接口定义88.1 DSMP与业务网关之间的接口(Sg接口)88.2 DSMP与BOSS
2、系统接口(Mb接口)88.3 DSMP与SCP接口(Sscp接口)88.4 DSMP与客服/1860之间的接口(Sk接口)98.5 DSMP之间的接口(Sim接口)98.6 DSMP与SP之间的接口(Ma接口)98.6.1 DSMP与SP之间接口消息定义98.6.2 DSMP与SP之间接口消息体定义99 返回值的统一定义1110 编制历史15附录A 模式（schema）描述16Schema字段描述16附录B DSMP与SCP之间通信协议中共用的通用元素的定义17附录C DSMP平台Web Services 数据类型定义17附录D DSMP平台Web Services 接口定义和SOAP绑定19
3、1 DSMP平台Web Service接口设计和开发准则192 举例说明203 DSMP接口的WSDL定义23前 言本接口规范规定了中国移动通信集团公司移动数据业务管理平台（DSMP）涉及到的接口与协议规范，包括DSMP与SMS、MMS、KJAVA、WAP等业务网关之间的接口/协议，DSMP与MAIL等应用平台之间的接口/协议，DSMP与BOSS之间的接口/协议，DSMP与SCP之间的接口/协议。本接口规范是集团公司开展移动数据业务的依据。本标准由中国移动通信集团公司技术部提出并归口。本标准由标准提出并归口部门负责解释。本标准起草单位：中国移动研发中心、中国移动香港卓望数码有限公司。本标准主要
4、起草人：魏冰、周彬、陈瑞卿、段晓东、王崇萍。本标准解释单位：同提出单位。1 适用范围本规范规定了中国移动数据业务管理平台与各个业务网关以及应用平台之间的接口，以保证系统的互连互通及业务的实现。 本规范主要适用于中国移动数据业务管理平台，提供管理平台和业务平台之间的连接的规范和技术实现规范。本规范描述的是数据业务在运营过程中涉及到的业务接口，有关网管、系统管理的接口不在本规范的描述范围之内，具体请参见设备规范。和BOSS系统的接口规范也不包含在本接口规范中，具体请参见中国移动通信集团公司BOSS与业务平台接口规范。2 引用标准下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。本标准出版
5、时，所示版本均为有效。所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的可能性。【1】 中国移动数据业务总体技术要求【2】 ISMG与SCP之间通信协议（事务层）规范【3】 中国移动通信信息资源站实体与互联网短消息网关接口协议【4】 移动梦网短信业务技术方案【5】 中国移动多媒体消息业务规范【6】 中国移动通信互联网短信网关接口协议【7】 中国移动WLAN业务总体技术要求【8】 中国移动WLAN业务规范【9】 中国移动互联网技术体制【10】 中国移动GPRS网络技术体制【11】 ITU_T 建议Q.1228(09/97) 【12】 ITU_T 建议X.500(11/93) 【13
6、】 ISMG与SCP通信协议（事务层）规范（V1.0）【14】 Short Message Peer to Peer Protocol Specification v3.4【15】 IETF “RFC 2068: Hypertext Transfer Protocol _ HTTP/1.1”【16】 W3C Working Draft SOAP Version 1.2 Part 2: Adjuncts, Martin Gudgin, Marc Hadley, Jean_Jacques Moreau, Henrik Frystyk Nielsen, 2 10 2001 (See http:/ww
7、w.w3.org/TR/2001/WD_soap12_part2_20011217/.) 【17】 IETF RFC 2616: Hypertext Transfer Protocol _ HTTP/1.1, R. Fielding, J. Gettys, J. C. Mogul, H. Frystyk, T. Berners_Lee, January 1997. (See http:/www.ietf.org/rfc/rfc2616.txt.) 【18】 IETF RFC 2119: Key words for use in RFCs to Indicate Requirement Leve
8、ls, S. Bradner, March 1997. (See http:/www.ietf.org/rfc/rfc2119.txt.) 【19】 W3C Recommendation XML Schema Part 1: Structures, Henry S. Thompson, David Beech, Murray Maloney, Noah Mendelsohn, 2 May 2001. (See http:/www.w3.org/TR/2001/REC_xmlschema_1_20010502/.) 【20】 W3C Recommendation XML Schema Part
9、2: Datatypes, Paul V. Biron, Ashok Malhotra,2May2001.(Seehttp:/www.w3.org/TR/2001/REC_xmlschema_2_20010502/.) 【21】 IETF RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax, T. Berners_Lee, R. Fielding, L. Masinter, August 1998. (See http:/www.ietf.org/rfc/rfc2396.txt.) 【22】 W3C Recommendati
10、on Namespaces in XML, Tim Bray, Dave Hollander, Andrew Layman,14January1999.(See http:/www.w3.org/TR/1999/REC_xml_names_19990114/.) 【23】 W3C Recommendation Extensible Markup Language (XML) 1.0 (Second Edition), Tim Bray, Jean Paoli, C. M. Sperberg_McQueen, Eve Maler, 6 October 2000. (See http:/www.w
11、3.org/TR/2000/REC_xml_20001006.) 【24】 W3C Recommendation XML Linking Language (XLink) Version 1.0, Steve DeRose, Eve Maler, David Orchard, 27 June 2001. (See http:/www.w3.org/TR/2001/REC_xlink_20010627/.) 【25】 W3C Recommendation XML Information Set, John Cowan, Richard Tobin, 24 October 2001. (See h
12、ttp:/www.w3.org/TR/2001/REC_xml_infoset_20011024/.) 【26】 W3C Recommendation XML Base, Johnathan Marsh, 27 June 2001. (See http:/www.w3.org/TR/2001/REC_xmlbase_20010627/.) 【27】 IETF RFC 2732: Format for Literal IPv6 Addresses in URLs, R. Hinden, B. Carpenter, L. Masinter, December 1999. (See http:/ww
13、w.ietf.org/rfc/rfc2732.txt.)3 相关术语与缩略语解释DSMP数据业务管理平台MISCMobile Information Service Center，移动信息服务中心BOSSBusiness Operation Support System，业务运营支撑系统SCPService Control point，服务控制点OTAOver The Air, 即空中、无线方式。KjavaA key component of Java 2 Platform，Micro EditionJ2MEJAVA 2 Micro Edition, 即小型手持系统使用的JAVA。HTTPHy
14、per Text Transfer Protocol，超文本传输协议。JAMJAVA Application Manager, JAVA应用管理器CSDCircuit Switch Data, 电路交换数据GPRSGeneral Packet Radio Service, 通用无线分组业务WAPWireless Application Protocol, 无线应用协议APNAccess Point Network, 接入点网络ICPInternet Content Provider，因特网内容提供商CDRCall Detail Record，呼叫详细记录FTPFile Transfer Pro
15、tocol，文件传输协议MISCMobile Information Service Central，移动信息业务中心LDAPLightweight Directory Access Protocol, 轻量级目录访问协议MOMobile Originate，手机用户发起MTMobile Terminate，手机用户终止AOApplication Oriented，应用发起ATApplication Terminated，应用终止MMS Multimedia Messaging Service，多媒体短消息服务MMSCMultimedia Messaging Service Center，多媒
16、体断消息服务中心ISMGInternet Short Message Gateway，互联网短消息网关SMPPShort Message Peer to Peer，短消息点对点协议SMSCShort Message Service Center，短消息中心SMTPSimple Mail Transfer Protocol，简单邮件传输协议WAPWireless Application Protocol，无线应用协议SPService Provider，服务提供商SSOSingle Sign On，单点登录MPSMicro Payment System，小额支付系统MPPMicro Paymen
17、t Platform，小额支付平台MPAMicro Payment Agent，小额支付代理LCSLocation Service，位置服务CMPPChina Mobile Peer to Peer protocol，中国移动点对点协议IMAP4Internet Message Access Protocol version 4POP3Post Office Protocol version 3RADIUSRemote Authentication Dial In User ServiceWWWWorld Wide WebGSMGlobal System for Mobile Communic
18、ations全球移动通信系统XMLeXtensible Markup Language，可扩展标记语言4接口命名规范 接口名称采用单词首字母大写，其他字母小写的方式。缩略语中的字母都大写。消息内容定义中，基本数据类型的字段命名规范采用单词首字母大写，单词间没有连接符的方式。对用Schema定义的字段在单词间加_连接符。5 接口在网络中的位置DSMP在整个数据业务框架中处于核心地位，它是数据业务的基础设施。考虑到数据业务需求特点：数据业务需求变化快，应用的多样化、个性化需求高，应用的实效性要求很高，同时中国移动不可能提供所有的应用，需要和第三方配合。就要求DSMP具有高可靠性、灵活的扩展能力。结
19、构图如下：6系统接口描述6.1 DSMP对外接口描述DSMP和外部实体之间的接口如下图所示： 我们下面描述一下本规范需要定义的接口：Sg接口：DSMP与业务网关、SP代理、应用平台、PORTAL之间的接口，DSMP通过该接口为业务网关、SP代理、应用平台、PORTAL提供数据业务管理平台的用户和SP的相关资源。Sb接口：DSMP与BOSS系统的接口，该接口实现DSMP与BOSS系统之间的用户及业务信息同步、话单传递、鉴权、客户管理、统一账户功能。SScp接口：DSMP与SCP的接口，DSMP通过该接口实现移动预付费用户的实时扣费。Sk接口：DSMP与客服/1860的接口。Sim接口：DSMP之
20、间的接口，DSMP之间通过该接口用户的基本数据和订购关系及全网SP及服务的相关信息的同步。Ma接口：DSMP与SP之间的接口，DSMP通过该接口进行订购关系同步和在用户自助服务时设置于订购服务相关的属性。6.2接口消息实现DSMP接口格式采用基于HTTP的SOAP协议，以WebService的方式进行相互之间的通信，要求HTTP的版本为1.1以上。DSMP接口的WEB SERVICE具体定义请参看附件C和D。7 字段类型说明integer：十进制的整数型。unsigned integer：十进制的无符号整数型。string：由char组成的字符串binary：由byte组成的字符串，由于XML
21、不能直接承载二进制数据，所以对该类型的数据采用BASE64编码。8 DSMP接口定义8.1 DSMP与业务网关之间的接口(Sg接口)8.2 DSMP与BOSS系统接口(Mb接口)8.3 DSMP与SCP接口(Sscp接口) 8.4 DSMP与客服/1860之间的接口(Sk接口) 8.5 DSMP之间的接口(Sim接口) 8.6 DSMP与SP之间的接口(Ma接口)DSMP通过该接口将订购关系同步给SP，具体接口消息参见下表。在用户自助服务时，如果在用户订购服务时需要设置与该服务相关的属性，则通过该接口修改于服务相关的属性。该接口是通过连接实现的。8.6.1 DSMP与SP之间接口消息定义消息名
22、称消息描述 SyncOrderRelationReq订购关系同步消息SyncOrderRelationResp订购关系同步应答消息8.6.2 DSMP与SP之间接口消息体定义8.6.2.1订购关系同步消息接口消息定义（SyncOrderRelationReq）8.6.2.1.1功能描述此接口在DSMP因为某种情况更新了用户订购关系（包括订购、取消、暂停、激活）的时候，通过此接口发起和SP的更新订购关系的交互。消息名消息类型消息方向SyncOrderRelationReqRequestDSMPSPSyncOrderRelationRespResponseSPDSMP8.6.2.1.2接口内容描述
23、SyncOrderRelationReq消息字段描述：返回定义重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”Send_Address必须address_info_schema发送方的地址Dest_Address必须address_info_schema接收方的地址FeeUser_ID必须user_id_schema计费用户标识DestUser_ID必须user_id_schema使用用户标识LinkID可选string临时订购关系的事务IDAct
24、ionID必须integer服务状态管理动作代码，具体值如下：1： 开通服务；2： 停止服务；3： 激活服务；4： 暂停服务；ActionReasonID必须integer产生服务状态管理动作原因的代码，具体值如下：1：用户发起行为2：Admin&1860发起行为3：Boss停机4：Boss开机5：Boss过户6：Boss销户7：Boss改号8：扣费失败导致的服务取消9：其他SPID可选stringSP的企业代码SPServiceID必须stringSP中该服务的服务代码AccessMode可选Integer服务的访问方式1：WEB2：WAP3：SMSFeatureStr可选binary服务订
25、购参数SyncOrderRelationResp消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值，详细定义见第9章9 返回值的统一定义在HTTP通信时的状态码请参见HTTP/1.1协议中规定的状态码值，不包含在本规范的返回值统一定义中。具体描述如下：0：成功1：未知错误2-99：保留100999为业务网关和DSMP之间的接口消息中的错误代码，如下：100：手机号码不存在101：手机号码错误102：
26、用户停机103：用户欠费104：用户没有使用该业务的权限105：业务代码错误106：服务代码错误107：业务不存在108：该业务暂停服务109：该服务种类不存在110：该服务种类尚未开通111：该业务尚未开通112：SP代码错误113：SP不存在114：SP暂停服务115：用户没有定购该业务116：用户暂停定购该业务117：该业务不能对该用户开放118： 用户已经订购了该业务119：用户不能取消该业务120：话单格式错误121：没有该类业务122：接收异常123：业务价格为负124：业务价格格式错误125：业务价格超出范围126：该用户不是神州行用户127：该用户没有足够的余额128：补款,冲
27、正失败129：用户已经是梦网用户130：用户在BOSS中没有相关用户数据131：BOSS系统数据同步出错132：相关信息不存在133：用户数据同步出错134：SP数据同步出错135：业务数据同步出错136：用户密码错误137：伪码信息错误138：用户相关信息不存在DSMP和SCP之间的接口消息中的错误代码定义如下：200：正常应答205：注册成功206：注册不成功207：注销成功208：注销失败209：无临时话单400：服务器端无法理解请求CMPP包401：用户未被认证,应答包中包含Authenticate,要用户认证413：请求实体太长414：梦网内部实体间的XML消息体错误415：SP发给
28、GW的XML消息体错误500：服务器的内部处理出错501：服务器忙，拒绝请求502：GW与SCP的连接中断，拒绝请求505：版本号不支持506： 服务器方超时40004999为DSMP与SP之间的接口消息中的错误代码：4000：无效的msgtype4001：无效的action_id；4002：无效的action_reasonid；4003：无效的SP ID4004：无效的serviceID4005：无效的pseudocode4006：无效的accessmode4007：MISC同步开通服务,但SP端已存在订购关系,且状态为开通4008：MISC同步开通服务,且SP端不存在订购关系,但开通服务失
29、败4009：MISC同步开通服务,但SP端已存在订购关系, 且状态为暂停4010：MISC同步停止服务, 且SP端存在订购关系, 但取消服务失败4011：MISC同步停止服务, 但SP端不存在订购关系4012：MISC同步暂停服务, 且SP端存在订购关系, 但暂停服务失败4013：MISC同步暂停服务, 但SP端不存在订购关系4014：MISC同步暂停服务, 但SP端已存在订购关系, 且状态为暂停4015：MISC同步激活服务, 但SP端已存在订购关系, 且状态为开通4016：MISC同步激活服务, 但SP端不存在订购关系4017：MISC同步激活服务, 且SP端存在订购关系, 但激活服务失败
30、9000-9999为系统级错误：9000：系统磁盘读写错误9001：网络异常9002：网络错误9003：业务网关忙，业务网关缓存9004：业务网关忙，并且业务网关缓冲区满，DSMP缓存，并暂时不要发送消息，等待一段时间重试。9005：DSMP忙，DSMP缓存9006：DSMP忙，并且DSMP缓冲区满，业务网关缓存，并暂时不要发送消息，等待一段时间重试。9007：业务网关超过限制的流量9008：DSMP异常，并不可用9009：业务网关异常，并不可用9010：该业务网关没有权限调用该接口消息9011：DSMP没有权限发送该接口消息给业务网关9012：版本不支持9013：消息类型不对，系统不支持90
31、14：验证错误，无法解析SOAP和XML结构、缺少必须存在的字段，或者消息格式不正确9015：拒绝消息，服务器无法完成请求的服务10 编制历史版本号更新时间主要内容或重大修改1002003年1月100版本1502003年4月150版本 附录A 模式（schema）描述Schema字段描述address_info_schema(地址信息)字段名称字段类型字段描述DeviceTypeinteger设备类型0：DSMP100：ISMG101：WAP SP PROXY1XX：其他业务网关200：WAP PORTAL201：WWW PORTAL202：VOICE PORTAL203：PDA PORTAL
32、2XX：其他门户300：MMSC301：KJAVA SERVER302：LSP3XX：其它应用平台400：SPDeviceIDstring设备编号，设备编号采用各设备的入网编号，例如短信网关使用网关ID、对SP使用其企业代码，该设备编号由DSMP分配，并且在同一设备类型中该编号唯一user_id_schema(用户标识)字段名称字段类型字段描述UserIDTypeinteger用户标识类型1：用手机号标识2：用伪码标识3：两者同时标识MSISDNstring用户手机号PseudoCodebinary用户伪码附录B DSMP与SCP之间通信协议中共用的通用元素的定义附录C DSMP平台Web S
33、ervices 数据类型定义附录D DSMP平台Web Services 接口定义和SOAP绑定1 DSMP平台Web Service接口设计和开发准则DSMP规范中的所有Web Service接口依据W3C组织颁布的Web Services Description Language (WSDL) 1.1(2001/03/15)规范而设计和定义，并与WSDL标准后续版本中的相关规定的保持一致性。所有采用DSMP规范的产品的接口设计和开发应遵守以下原则：l 接口中的所有消息及相关数据类型的XML模式定义均应采用由本规范提供的XML模式定义，内容详见附录C。部署Web Service时，所有由DS
34、MP定义的XML模式定义均被包含在dsmp.xsd文件中，并以公开的URL地址被引用。在WSDL定义中采用名为dsmp的命名空间来限定，在WSDL定义中为xmlns:dsmp=”附录为DSMP规范定义了所有被引用到的类型和元素的命名空间及XML模式，此命名空间作用范围涵盖所有WSDL接口消息。SOAP消息中命名空间的使用方法见第2节的举例说明。l 接口的WSDL定义均应采用本规范提供的WSDL定义，内容详见本附录的第3节。部署Web Service时，所有WSDL定义内容被包含在dsmp.wsdl文件中，并以公开的URL被引用。按照WSDL标准的规定，本规范接口的WSDL定义主要包含如下部分：
35、 类型（Types）：本规范采用的是文件引用的方法，所有DSMP规范定义的消息类型被包含在dsmp.xsd文件中； 消息（Message）：即在调用过程中产生的请求或响应的SOAP封装里的消息结构； 操作（Operation）：被本规范定义的Web Service所支持的动作的理论描述； 端口类型（Port Type）：被终端所支持的一套操作的集合的定义； 绑定（Binding）：即SOAP绑定的定义部分，按照WSDL1.1标准，端口类型被绑定到SOAP1.1协议，因而，任何采用DSMP规范的产品，无论采用何种支持Web Service的中间件平台或SOAP专用程序来实现Web Service
36、接口，或是调用Web Service接口，均应支持对SOAP1.1的绑定。例如对调用者而言，只有向服务器端发送标准的SOAP封装消息包，才能得到正确的返回，否则均被视作调用格式错误； 端口（Port）：即实现接口的程序的网络地址的定义； 服务（Service）：即实现接口的一系列端口集。l SOAP绑定原则本规范定义的Web Service接口与SOAP1.1协议格式相绑定，所有请求和响应消息均应采用SOAP格式的消息封装，包含 SOAP封套(Envelope)，SOAP包头(Header)和SOAP包体（Body）三部分。对任何技术实现的调用者而言，发出的调用请求消息均须带有以上三部分内容，
37、包头和包体消息结构中引用的类型均来自dsmp.xsd中的定义。但在SOAP包体中，如果按照规范定义某一参数为可选，则SOAP消息中可不包含标识该参数的元素。返回的SOAP消息结构同请求消息；l 在本规范中，为支持事物处理而定义的TransactionID参数被包含在SOAP包头中传送，因而，本规范要求所有SOAP消息均必须带有SOAP包头，接口程序应根据需要对SOAP包头中的TransactionID做相应的处理（用来标识事物或忽略）。TransactionID的产生规则是DeviceID+10位的数字，该10位数字从1开始，并且不足10位的前补0。每次增长的步长为1，依次循环使用。l 本规范遵循WSDL标准，接口通讯层与HTTP1.1协议的POST和GET绑定在一起。按本规范规定，服务器和客户端之间均通过HTTP的POST方法来进行交互。与此相关，HTTP报文内容格式与MIME格式绑定，例如Content-Type为text/xml等均遵循MIME标准。l 本规范中的WSDL和XSD里所定义的URI并非普遍适用，在实际部署的Web Service平台产品中应被修改为真实
