《中国移动移动数据业务管理平台(DSMP)接口规范.doc》由会员分享，可在线阅读，更多相关《中国移动移动数据业务管理平台(DSMP)接口规范.doc（197页珍藏版）》请在三一办公上搜索。
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.1.1 DSMP与业务
2、网关之间接口消息定义88.1.2 DSMP与业务网关之间接口消息体定义118.2 DSMP与BOSS系统接口(Mb接口)698.3 DSMP与SCP接口(Sscp接口)708.3.1 DSMP与SCP之间接口消息定义708.3.2 DSMP与SCP之间接口消息体定义708.4 DSMP与客服/1860之间的接口(Sk接口)768.5 DSMP之间的接口(Sim接口)768.5.1 DSMP之间接口消息定义768.5.2 DSMP之间接口消息体定义778.6 DSMP与SP之间的接口(Ma接口)828.6.1 DSMP与SP之间接口消息定义828.6.2 DSMP与SP之间接口消息体定义829
3、返回值的统一定义8410 编制历史89附录A 模式（schema）描述90Schema字段描述90附录B DSMP与SCP之间通信协议中共用的通用元素的定义1221 元素addr的定义1222 元素chg-info的定义1223 元素desc的定义122附录C DSMP平台Web Services 数据类型定义123附录D DSMP平台Web Services 接口定义和SOAP绑定1581 DSMP平台Web Service接口设计和开发准则1582 举例说明1593 DSMP接口的WSDL定义162前 言本接口规范规定了中国移动通信集团公司移动数据业务管理平台（DSMP）涉及到的接口与协议
4、规范，包括DSMP与SMS、MMS、KJAVA、WAP等业务网关之间的接口/协议，DSMP与MAIL等应用平台之间的接口/协议，DSMP与BOSS之间的接口/协议，DSMP与SCP之间的接口/协议。本接口规范是集团公司开展移动数据业务的依据。本标准由中国移动通信集团公司技术部提出并归口。本标准由标准提出并归口部门负责解释。本标准起草单位：中国移动研发中心、中国移动香港卓望数码有限公司。本标准主要起草人：魏冰、周彬、陈瑞卿、段晓东、王崇萍。本标准解释单位：同提出单位。1 适用范围本规范规定了中国移动数据业务管理平台与各个业务网关以及应用平台之间的接口，以保证系统的互连互通及业务的实现。 本规范主
5、要适用于中国移动数据业务管理平台，提供管理平台和业务平台之间的连接的规范和技术实现规范。本规范描述的是数据业务在运营过程中涉及到的业务接口，有关网管、系统管理的接口不在本规范的描述范围之内，具体请参见设备规范。和BOSS系统的接口规范也不包含在本接口规范中，具体请参见中国移动通信集团公司BOSS与业务平台接口规范。2 引用标准下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。本标准出版时，所示版本均为有效。所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的可能性。【1】 中国移动数据业务总体技术要求【2】 ISMG与SCP之间通信协议（事务层）规范【3】 中国移动通信信
6、息资源站实体与互联网短消息网关接口协议【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】 ISMG与SCP通信协议（事务层）规范（V1.0）【14】 Short Message Peer to Peer Protocol Specification v3.4【15】 IETF “RFC
7、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:/www.w3.org/TR/2001/WD_soap12_part2_20011217/.) 【17】 IETF RFC 2616: Hypertext Transfer Protocol _ HTTP/1
8、.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 Levels, S. Bradner, March 1997. (See http:/www.ietf.org/rfc/rfc2119.txt.) 【19】 W3C Recommendation XML Sch
9、ema 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 2: Datatypes, Paul V. Biron, Ashok Malhotra,2May2001.(Seehttp:/www.w3.org/TR/2001/REC_xmlschema_2_200
10、10502/.) 【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 Recommendation Namespaces in XML, Tim Bray, Dave Hollander, Andrew Layman,14January1999.(See http:/www.w3.org/TR/
11、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.w3.org/TR/2000/REC_xml_20001006.) 【24】 W3C Recommendation XML Linking Language (XLink) Version 1.0, St
12、eve 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 http:/www.w3.org/TR/2001/REC_xml_infoset_20011024/.) 【26】 W3C Recommendation XML Base, Johnathan Marsh
13、, 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:/www.ietf.org/rfc/rfc2732.txt.)3 相关术语与缩略语解释DSMP数据业务管理平台MISCMobile Information Service Center，移动信息服务中心BOS
14、SBusiness Operation Support System，业务运营支撑系统SCPService Control point，服务控制点OTAOver The Air, 即空中、无线方式。KjavaA key component of Java 2 Platform，Micro EditionJ2MEJAVA 2 Micro Edition, 即小型手持系统使用的JAVA。HTTPHyper Text Transfer Protocol，超文本传输协议。JAMJAVA Application Manager, JAVA应用管理器CSDCircuit Switch Data, 电路交换
15、数据GPRSGeneral Packet Radio Service, 通用无线分组业务WAPWireless Application Protocol, 无线应用协议APNAccess Point Network, 接入点网络ICPInternet Content Provider，因特网内容提供商CDRCall Detail Record，呼叫详细记录FTPFile Transfer Protocol，文件传输协议MISCMobile Information Service Central，移动信息业务中心LDAPLightweight Directory Access Protocol,
16、 轻量级目录访问协议MOMobile Originate，手机用户发起MTMobile Terminate，手机用户终止AOApplication Oriented，应用发起ATApplication Terminated，应用终止MMS Multimedia Messaging Service，多媒体短消息服务MMSCMultimedia Messaging Service Center，多媒体断消息服务中心ISMGInternet Short Message Gateway，互联网短消息网关SMPPShort Message Peer to Peer，短消息点对点协议SMSCShort M
17、essage Service Center，短消息中心SMTPSimple Mail Transfer Protocol，简单邮件传输协议WAPWireless Application Protocol，无线应用协议SPService Provider，服务提供商SSOSingle Sign On，单点登录MPSMicro Payment System，小额支付系统MPPMicro Payment Platform，小额支付平台MPAMicro Payment Agent，小额支付代理LCSLocation Service，位置服务CMPPChina Mobile Peer to Peer p
18、rotocol，中国移动点对点协议IMAP4Internet Message Access Protocol version 4POP3Post Office Protocol version 3RADIUSRemote Authentication Dial In User ServiceWWWWorld Wide WebGSMGlobal System for Mobile Communications全球移动通信系统XMLeXtensible Markup Language，可扩展标记语言4接口命名规范 接口名称采用单词首字母大写，其他字母小写的方式。缩略语中的字母都大写。消息内容定义中
19、，基本数据类型的字段命名规范采用单词首字母大写，单词间没有连接符的方式。对用Schema定义的字段在单词间加_连接符。5 接口在网络中的位置DSMP在整个数据业务框架中处于核心地位，它是数据业务的基础设施。考虑到数据业务需求特点：数据业务需求变化快，应用的多样化、个性化需求高，应用的实效性要求很高，同时中国移动不可能提供所有的应用，需要和第三方配合。就要求DSMP具有高可靠性、灵活的扩展能力。结构图如下：6系统接口描述6.1 DSMP对外接口描述DSMP和外部实体之间的接口如下图所示： 我们下面描述一下本规范需要定义的接口：Sg接口：DSMP与业务网关、SP代理、应用平台、PORTAL之间的接
20、口，DSMP通过该接口为业务网关、SP代理、应用平台、PORTAL提供数据业务管理平台的用户和SP的相关资源。Sb接口：DSMP与BOSS系统的接口，该接口实现DSMP与BOSS系统之间的用户及业务信息同步、话单传递、鉴权、客户管理、统一账户功能。SScp接口：DSMP与SCP的接口，DSMP通过该接口实现移动预付费用户的实时扣费。Sk接口：DSMP与客服/1860的接口。Sim接口：DSMP之间的接口，DSMP之间通过该接口用户的基本数据和订购关系及全网SP及服务的相关信息的同步。Ma接口：DSMP与SP之间的接口，DSMP通过该接口进行订购关系同步和在用户自助服务时设置于订购服务相关的属性
21、。6.2接口消息实现DSMP接口格式采用基于HTTP的SOAP协议，以WebService的方式进行相互之间的通信，要求HTTP的版本为1.1以上。DSMP接口的WEB SERVICE具体定义请参看附件C和D。7 字段类型说明integer：十进制的整数型。unsigned integer：十进制的无符号整数型。string：由char组成的字符串binary：由byte组成的字符串，由于XML不能直接承载二进制数据，所以对该类型的数据采用BASE64编码。8 DSMP接口定义8.1 DSMP与业务网关之间的接口(Sg接口)8.1.1 DSMP与业务网关之间接口消息定义8.1.1.1(消息方向
22、)业务网关DSMP消息名称消息描述UserRegisterReq用户注册接口消息DeleteUserReq用户注销接口消息UserAuthenticateReq用户鉴权接口消息QueryUserProfileReq查询用户信息接口消息UpdateUserProfileReq更新用户信息接口消息UpdateUserPasswdReq修改用户密码接口消息RefreshPasswdReq重新生成用户密码接口消息SPAuthInfoReq查询SP接入鉴权信息请求接口消息ServiceAuthenticateReq服务鉴权接口消息SubscribeServiceReq服务订购接口消息UnSubscrib
23、eServiceReq取消服务订购接口消息PauseSubscribeServiceReq暂停订购的服务接口消息ActiveSubscribeServiceReq激活订购的服务接口消息QueryOrderedServicesReq服务订购信息查询接口消息OrderRelationAuthenticateReq服务订购关系鉴权接口消息MsgCnfmReq服务完成的确认接口消息GetSPListReq查询SP列表接口消息GetSPInfoReq查询SP信息接口消息GetSPServiceListReq查询SP服务列表接口消息GetServiceListByTypeReq根据服务类型查询服务列表接口
24、消息GetServiceIDByFeatureReq根据服务特征串查询服务标识接口消息GetServiceInfoReq查询服务详细信息接口消息GetServiceListByTimeReq查询指定时间后更新的服务信息的接口消息UserPricingReq实时批价接口消息MonthFeeReq出包月话单请求接口消息MonthFeeReceiptResp包月话单状态报告应答接口消息ChargeReq扣款请求接口消息CnfmReq扣款确认/补款接口消息AuthPriceReq鉴权/批价接口消息AuthPriceCnfmReq鉴权/批价确认接口消息SendCDRReq话单传送请求接口消息UserIn
25、foModNotifyResp用户数据更新通知应答接口消息SpInfoModNotifyRespSP数据更新通知应答接口消息ServiceInfoModNotifyResp服务数据更新通知应答接口消息QueryUserOrderHistoryReq查询用户订购历史接口消息UserIDTransformReq用户MSISDN与伪码的转换接口消息ActiveTestReq链路激活测试接口消息ActiveTestResp链路激活测试应答接口消息8.1.1.2 (消息方向)DSMP-业务网关消息名称消息描述UserRegisterResp用户注册应答接口消息DeleteUserResp用户注销应答接口
26、消息UserAuthenticateResp用户鉴权应答接口消息QueryUserProfileResp查询用户信息应答接口消息UpdateUserProfileResp更新用户信息应答接口消息UpdateUserPasswdResp修改用户密码应答接口消息RefreshPasswdResp重新生成用户密码应答接口消息SPAuthInfoResp查询SP接入鉴权信息应答接口消息ServiceAuthenticateResp服务鉴权应答接口消息SubscribeServiceResp服务订购应答接口消息UnSubscribeServiceResp取消服务订购应答接口消息PauseSubscrib
27、eServiceResp暂停订购的服务应答接口消息ActiveSubscribeServiceResp激活订购的服务应答接口消息QueryOrderedServicesResp服务订购信息查询应答接口消息OrderRelationAuthenticateResp服务订购关系鉴权应答接口消息MsgCnfmResp服务完成的确认应答接口消息GetSPListResp查询SP列表应答接口消息GetSPInfoResp获取SP信息应答接口消息GetSPServiceListResp获取SP服务列表应答接口消息GetServiceListByTypeResp根据服务类型查询服务列表应答接口消息GetSe
28、rviceIDByFeatureResp根据服务特征串查询服务标识应答接口消息GetServiceInfoResp查询服务详细信息应答接口消息GetServiceListByTimeResp查询指定时间后更新的服务信息应答接口消息UserPricingRespResp实时批价应答接口消息MonthFeeReq出包月话单请求接口消息MonthFeeReceiptReq包月话单状态报告接口消息ChargeResp扣款请求应答接口消息CnfmResp扣款确认/补款应答接口消息AuthPriceResp鉴权/批价应答接口消息AuthPriceCnfmResp鉴权/批价确认应答接口消息SendCDRRe
29、sp话单传送应答接口消息UserInfoModNotifyReq用户数据更新通知接口消息SpInfoModNotifyReqSP数据更新通知接口消息ServiceInfoModNotifyReq服务数据更新通知接口消息QueryUserOrderHistoryResp查询用户订购历史应答接口消息UserIDTransformResp用户MSISDN与伪码的转换接口消息ActiveTestReq链路激活测试接口消息ActiveTestResp链路激活测试应答接口消息8.1.2 DSMP与业务网关之间接口消息体定义8.1.2.1用户注册接口消息定义(UserRegisterReq)8.1.2.1.
30、1功能描述此接口用于用户通过业务网关或Portal注册成为中国移动的数据业务用户时，业务网关或Portal的通过该接口向DSMP传递用户注册的请求，DSMP对用户的有效性进行检查，检查成功后用户注册成为数据业务的注册用户，并生成用户在数据业务平台中的伪码(伪码的定义详见数据业务管理平台设备规范的相关定义)，作为用户使用移动数据业务的标识。消息名消息类型消息方向UserRegisterReqRequest业务网关DSMPUserRegisterRespResponseDSMP业务网关8.1.2.1.2接口内容描述UserRegisterReq消息字段描述：字段名重要性类型说明MsgType必须s
31、tring消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”Send_Address必须address_info_schema发送方的地址Dest_Address必须address_info_schema接收方的地址User_ID必须user_id_schema用户标识User_Profile必须user_profile_schema用户基本信息User_Platform_Profile可选user_service_platform_schema用户的服务相关信息UserRegisterRes
32、p消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值,见第9章的定义PseudoCode条件binaryDSMP生成的用户伪码，根据hRet的值来定，如果该值表示返回成功，则该字段必须存在，如果返回出错，则该字段不填。8.1.2.2用户注销接口消息定义(DeleteUserReq)8.1.2.2.1功能描述此接口用于用户通过Portal或客服系统注销用户在DSMP中的身份时，向DSMP发送本请求，D
33、SMP收到消息后，进行相应的处理，返回应答消息并在本帐期结束后，注销该用户。消息名消息类型消息方向DeleteUserReqRequest业务网关DSMPDeleteUser RespResponseDSMP业务网关8.1.2.2.2接口内容描述DeleteUserReq消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”Send_Address必须address_info_schema发送方的地址Dest_Address必须add
34、ress_info_schema接收方的地址Use_ ID必须user_id_schema用户标识DeleteUserResp消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值,见第9章的定义8.1.2.3用户鉴权接口消息定义(UserAuthenticateReq)8.1.2.3.1功能描述此接口用于用户登陆到DSMP或使用数据业务的时候，业务网关或Portal发送此消息到DSMP，对该用户使用数
35、据业务的合法性和有效性（状态是否为激活）进行检查，并返回结果。根据业务网关和Portal中用户进入方式的不同，提供四中方式的用户鉴权：1、 根据用户的MSISDN号码进行鉴权2、 根据用户的伪码进行鉴权3、 根据用户的MSISDN号码和密码进行鉴权4、 根据用户的伪码和密码进行鉴权不同的鉴权模式，AuthType(鉴权方式)填写不同的值，具体采用哪种方式，请参看各网元设备对应的接口规范分册的参考流程。消息名消息类型消息方向UserAuthenticateReqRequest业务网关DSMPUserAuthenticateRespResponseDSMP业务网关8.1.2.3.2接口内容描述Us
36、erAuthenticateReq消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”Send_Address必须address_info_schema发送方的地址Dest_Address必须address_info_schema接收方的地址User_ID必须user_id_schema用户标识AuthType必须integer鉴权类型1：根据用户的MSISDN号码进行鉴权2：根据用户的伪码进行鉴权3：根据用户的MSISDN号码和密
37、码进行鉴权4：根据用户的伪码和密码进行鉴权Password条件string用户口令，根据情况确定是否填写。如果AuthType为3或4则该字段必须存在，否则，则该字段是可选的。ServiceType必须integer本次业务的具体类别 0：单纯的鉴权(和具体业务无关，只判断业务的状态)1：SMSMO2：SMSMT3：WAP PULL4：WAP PUSH5：MMSAO6：MMSAT7：LBS8：KJAVA9：EMAIL10：WWW11：PDA12：待扩展UserAuthenticateResp消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须s
38、tring该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值，见第9章的定义。MSISDN条件string用户MSISDN号码，鉴权成功后返回，根据hRet的值来定，如果该值表示返回成功，则该字段必须存在，如果返回出错，则该字段不填。PseudoCode条件binary用户伪码，鉴权成功后返回，根据hRet的值来定，如果该值表示返回成功，则该字段必须存在，如果返回出错，则该字段不填。UserType条件integer用户类型(全球通、神州行)0：全球通1：神州行2：待扩展根据hRet的值来定，如果该值表示返回成
39、功，则该字段必须存在，如果返回出错，则该字段不填。ConnectDeviceID条件string用户归属的网元设备ID，用于下行服务的路由，当前只对短信业务有效8.1.2.4查询用户信息接口消息定义(QueryUserProfileReq)8.1.2.4.1功能描述此接口用于业务网关或Portal根据用户的MSISDN或PseudoCode(伪码)，查询用户的服务相关信息，DSMP收到此消息后，根据消息发送地址中的网元类型(DeviceTyp)回送该网元对应的用户服务相关信息，比如短信网关可以查询用户短信相关的信息，WAP网关可以查询用户WAP业务相关的信息等。消息名消息类型消息方向Query
40、UserProfileReqRequest业务网关DSMPQueryUserProfileRespResponseDSMP业务网关8.1.2.4.2接口内容描述QueryUserProfileReq消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的编号，本次所有的接口消息的版本都为“1.5.0”Send_Address必须address_info_schema发送方的地址Dest_Address必须address_info_schema接收方的地址User_ID必须user_id
41、_schema用户标识InfoDetail必须integer查询的信息类型：1：只查询基本信息2：查询本平台相关的用户信息3：查询用户基本信息和本平台相关的用户信息4：查询用户的所有信息QueryUserProfileResp消息字段描述：返回定义重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”hRet必须integer返回值,见第9章的定义User_ID必须user_id_schema用户标识User_Profile可选user_profile_
42、schema用户基本信息，根据hRet的值来定，如果该值表示返回成功，则该字段必须存在，如果返回出错，则该字段不填。User_Platform_Profile可选user_service_platform_schema用户的服务相关信息，根据hRet的值来定，如果该值表示返回成功，则该字段必须存在，如果返回出错，则该字段不填。8.1.2.5更新用户信息接口消息定义(UpdateUserProfileReq)8.1.2.5.1功能描述此接口用于业务网关或Portal根据用户的MSISDN或PseudoCode(伪码)修改用户与服务相关的信息。消息名消息类型消息方向UpdateUserProfil
43、eReqRequest业务网关DSMPUpdateUserProfileRespResponseDSMP业务网关8.1.2.5.2接口内容描述UpdateUserProfileReq消息字段描述：字段名重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接口消息的版本号，本次所有的接口消息的版本都为“1.5.0”Send_Address必须address_info_schema发送方的地址Dest_Address必须address_info_schema接收方的地址User_ID必须user_id_schema用户标识InfoDetail必须integer更新的用户信息类型：1：只更新基本信息2：更新本平台相关的用户信息3：更新用户基本信息和本平台相关的用户信息4：更新用户的所有信息User_ Profile可选user_profile_schema用户基本信息User_Platform_ Profile可选user_service_platform_schema用户的服务相关信息UpdateUserProfileResp消息字段描述：返回定义重要性类型说明MsgType必须string消息类型TransactionID必须string该消息编号Version必须string该接
