儂中國(guó)移動(dòng)通信

花夕CHINAMOBILE

中國(guó)移動(dòng)通信企業(yè)標(biāo)準(zhǔn)

QB-GF-003-2003

移動(dòng)數(shù)據(jù)業(yè)務(wù)治理平臺(tái)(DSMP)

接口范例

MobiIeDataServiceManagement

PlatformInterfaceSpecification

版本號(hào)：1.5.0

2003-1-31宣布2003-1-31實(shí)施

中國(guó)移動(dòng)通信團(tuán)體公司宣布

目錄

前言....................................................................................III

1適用范疇..................................................................................I

2引用標(biāo)準(zhǔn)..................................................................................2

3相關(guān)術(shù)語(yǔ)與縮略語(yǔ)解釋.....................................................................4

4接口命名范例..............................................................................5

5接口在網(wǎng)絡(luò)中的位置.......................................................................6

6系統(tǒng)接口描述..............................................................................7

6.1DSMP對(duì)外接口描述..................................................................7

6.2接口消息實(shí)現(xiàn).......................................................................8

7字段類型說(shuō)明..............................................................................8

8DSMP接口界說(shuō)............................................................................8

8.1DSMP與業(yè)務(wù)網(wǎng)關(guān)之間的接口（Sg接口）.................................................8

8.2DSMP與BOSS系統(tǒng)接口（Mb接口）....................................................8

8.3DSMP與SCP接口（Sscp接口）........................................................8

8.4DSMP與客服/1860之間的接口（Sk接口）...............................................9

8.5DSMP之間的接口（Sim接口）..........................................................9

8.6DSMP與SP之間的接口（Ma接口）.....................................................9

8.6.1DSMP與SP之間接口消息界說(shuō)..................................................9

8.6.2DSMP與SP之間接口消息體界說(shuō)...............................................9

9返回值的統(tǒng)一界說(shuō).........................................................................11

10體例歷史................................................................................15

附錄A模式（schema）描述.................................................................16

Schema字段描述..................................................................16

附錄BDSMP與SCP之間通信協(xié)議中共用的通用元素的界說(shuō)...................................17

附錄CDSMP平臺(tái)WebServices數(shù)據(jù)類型界說(shuō)...............................................17

附錄DDSMP平臺(tái)WebServices接口界說(shuō)和SOAP綁定...................................19

1DSMP平臺(tái)WebService接口設(shè)計(jì)和開(kāi)發(fā)準(zhǔn)則.............................................19

2舉例說(shuō)明.............................................................................20

3DSMP接口的WSDL界說(shuō)..............................................................23

前言

本接口范例規(guī)定了中國(guó)移動(dòng)通信團(tuán)體公司移動(dòng)數(shù)據(jù)業(yè)務(wù)治理平臺(tái)（DSMP）涉及到的接口與協(xié)議范例,

包羅DSMP與SMS、MMS、KJAVA、WAP等業(yè)務(wù)網(wǎng)關(guān)之間的接口/協(xié)議，DSMP與MAIL等應(yīng)用平臺(tái)之間的接口

/協(xié)議，DSMP與BOSS之間的接口/協(xié)議，DSMP與SCP之間的接口/協(xié)議。本接口范例是團(tuán)體公司開(kāi)展移

動(dòng)數(shù)據(jù)業(yè)務(wù)的依據(jù)。

本標(biāo)準(zhǔn)由中國(guó)移動(dòng)通信團(tuán)體公司技能部提出并歸口。

本標(biāo)準(zhǔn)由標(biāo)準(zhǔn)提出并歸口部分賣力解釋。

本標(biāo)準(zhǔn)起草單位：中國(guó)移動(dòng)研發(fā)中心、中國(guó)移動(dòng)香港卓望數(shù)碼有限公司。

本標(biāo)準(zhǔn)主要起草人：魏冰、周彬、陳瑞卿、段曉東、王崇萍。

本標(biāo)準(zhǔn)解釋單位：同提出單位。

1適用范疇

本范例規(guī)定了中國(guó)移動(dòng)數(shù)據(jù)業(yè)務(wù)治理平臺(tái)與各個(gè)業(yè)務(wù)網(wǎng)關(guān)以及應(yīng)用平臺(tái)之間的接口，以包管系統(tǒng)的

互連互通及業(yè)務(wù)的實(shí)現(xiàn)。

本范例主要適用于中國(guó)移動(dòng)數(shù)據(jù)業(yè)務(wù)治理平臺(tái)，提供治理平臺(tái)和業(yè)務(wù)平臺(tái)之間的連接的范例和技能

實(shí)現(xiàn)范例。

本范例描述的是數(shù)據(jù)業(yè)務(wù)在運(yùn)營(yíng)歷程中涉及到的業(yè)務(wù)接口，有關(guān)網(wǎng)管、系統(tǒng)治理的接口不在本范例

的描述范疇之內(nèi)，具體請(qǐng)拜見(jiàn)設(shè)備范例。和BOSS系統(tǒng)的接口范例也不包羅在本接口范例中，具體請(qǐng)拜

見(jiàn)《中國(guó)移動(dòng)通信團(tuán)體公司BOSS與業(yè)務(wù)平臺(tái)接口范例》。

2引用標(biāo)準(zhǔn)

下列標(biāo)準(zhǔn)所包羅的條文，通過(guò)在本標(biāo)準(zhǔn)中引用而成為本標(biāo)準(zhǔn)的條文。本標(biāo)準(zhǔn)出書時(shí)，所示版本均為

有效。所有標(biāo)準(zhǔn)都市被修訂，使用本標(biāo)準(zhǔn)的各方應(yīng)探討使用下列標(biāo)準(zhǔn)最新版本的可能性。

[1]中國(guó)移動(dòng)數(shù)據(jù)業(yè)務(wù)總體技能要求

[2]ISMG與SCP之間通信協(xié)議(事務(wù)層)范例

【3】中國(guó)移動(dòng)通信信息資源站實(shí)體與互聯(lián)網(wǎng)短消息網(wǎng)關(guān)接口協(xié)議

[4]移動(dòng)夢(mèng)網(wǎng)短信業(yè)務(wù)技能方案

【5】中國(guó)移動(dòng)多媒體消息業(yè)務(wù)范例

[6]中國(guó)移動(dòng)通信互聯(lián)網(wǎng)短信網(wǎng)關(guān)接口協(xié)議

[7]中國(guó)移動(dòng)WLAN業(yè)務(wù)總體技能要求

[81中國(guó)移動(dòng)WLAN業(yè)務(wù)范例

[9]中國(guó)移動(dòng)互聯(lián)網(wǎng)技能體制

[10]中國(guó)移動(dòng)GPRS網(wǎng)絡(luò)技能體制

[II]ITU_T發(fā)起Q1228(09/97)<<智能網(wǎng)能力集2接口發(fā)起>>

[12]ITU_T發(fā)起X.500(11/93)<<信息技能一開(kāi)放系統(tǒng)互連一目錄>>

[13]ISMG與SCP通信協(xié)議(事務(wù)層)范例(V1.0)

[14]ShortMessagePeertoPeerProtocolSpecificationv3.4

[15]IETF“RFC2068:HypertextTransferProtocol_HTTP/1.1"

[16]W3CWorkingDraft"SOAPVersion1.2Part2:Adjuncts",MartinGudgin,MarcHadley,

Jean_JacquesMoreau,HenrikFrystykNielsen,2102001(See

/TR/2001/WD_soap12_part2_20011217/.)

[17]IETF"RFC2616:HypertextTransferProtocol_HTTP/1.1",R.Fielding,J.Gettys,J.C.Mogul,

H.Frystyk,T.Berners_Lee,January1997.(See/rfc/rfc2616.txt.)

[18]IETF"RFC2119:KeywordsforuseinRFCstoIndicateRequirementLevels",S.Bradner,March

1997.(See/rfc/rfc2119.txt.)

[19]W3CRecommendation"XMLSchemaPart1:Structures",HenryS.Thompson,DavidBeech,

MurrayMaloney,NoahMendelsohn,2May2001.(See

/TR/2001/REC_xmlschema_1_20010502/.)

[20]W3CRecommendation"XMLSchemaPart2:Datatypes",PaulV.Biron,Ashok

Malhotra,2May2001.(See/TR/2001/REC_xmlschema_2_20010502/.)

[21]IETF"RFC2396:UniformResourceIdentifiers(URI):GenericSyntax",T.Berners_Lee,R.

Fielding,L.Masinter,August1998.(See/rfc/rfc2396.txt.)

[22]W3CRecommendation"NamespacesinXML",TimBray,DaveHollander,Andrew

Layman,14January1999.(See/TR/1999/REC_xml_names_19990114/.)

[23]W3CRecommendation"ExtensibleMarkupLanguage(XML)1.0(SecondEdition)'1,TimBray,

JeanPaoli,C.M.Sperberg_McQueen,EveMaier,6October2000.(See

/TR/2000/REC_xml_20001006.)

[24]W3CRecommendation"XMLLinkingLanguage(XLink)Version1.0",SteveDeRose,EveMaier,

DavidOrchard,27June2001.(See/TR/2001/REC_xlink_20010627/.)

[25]W3CRecommendation"XMLInformationSet*',JohnCowan,RichardTobin,24October2001.

(See/TR/2001/REC_xml_infoset_20011024/.)

[26]W3CRecommendation"XMLBase",JohnathanMarsh,27June2001.(See

/TR/2001/REC_xmlbase_20010627/.)

[27]IETF"RFC2732:FormatforLiteralIPv6AddressesinURL's",R.Hinden,B.Carpenter,L.

Masinter,December1999.(See/rfc/rfc2732.txt.)

3相關(guān)術(shù)語(yǔ)與縮略語(yǔ)解釋

DSMP數(shù)據(jù)業(yè)務(wù)治理平臺(tái)

MISCMobileInformationServiceCenter,移動(dòng)信息辦事中心

BOSSBusinessOperationSupportSystem,業(yè)務(wù)運(yùn)營(yíng)支撐系統(tǒng)

SCPServiceControlpoint,辦事控制點(diǎn)

OTAOverTheAir,即空中、無(wú)線方法。

KjavaAkeycomponentofJava2Platform,MicroEdition

J2MEJAVA2MicroEdition,即小型手持系統(tǒng)使用的JAVA。

HTTPHyperTextTransferProtocol,超文本傳輸協(xié)議。

JAMJAVAApplicationManager,JAVA應(yīng)用治理器

CSDCircuitSwitchData,電路互換數(shù)據(jù)

GPRSGeneralPacketRadioService,通用無(wú)線分組業(yè)務(wù)

WAPWirelessApplicationProtocol,無(wú)線應(yīng)用協(xié)議

APNAccessPointNetwork,接入點(diǎn)網(wǎng)絡(luò)

ICPInternetContentProvider,因特網(wǎng)內(nèi)容提供商

CDRCallDetailRecord,呼喚詳細(xì)記錄

FTPFileTransferProtocol,文件傳輸協(xié)議

MISCMobileInformationServiceCentral,移動(dòng)信息業(yè)務(wù)中心

LDAPLightweightDirectoryAccessProtocol,輕量級(jí)目錄訪問(wèn)協(xié)議

MOMobileOriginate,手機(jī)用戶提倡

MTMobileTerminate,手機(jī)用戶終止

AOApplicationOriented,應(yīng)用提倡

ATApplicationTerminated,應(yīng)用終止

MMSMultimediaMessagingService,多媒體短消息辦事

MMSCMultimediaMessagingServiceCenter,多媒體斷消息辦事中心

ISMGInternetShortMessageGateway,互聯(lián)網(wǎng)短消息網(wǎng)關(guān)

SMPPShortMessagePeertoPeer,短消息點(diǎn)對(duì)點(diǎn)協(xié)議

SMSCShortMessageServiceCenter,短消息中心

SMTPSimpleMai1TransferProtocol,簡(jiǎn)單郵件傳輸協(xié)議

WAPWirelessApplicationProtocol,無(wú)線應(yīng)用協(xié)議

SPServiceProvider,辦事提供商

SSOSingleSignOn,單點(diǎn)登錄

MPSMicroPaymentSystem,小額支付系統(tǒng)

MPPMicroPaymentPlatform,小額支付平臺(tái)

MPAMicroPaymentAgent,小額支付署理

LCSLocationService,位置辦事

CMPPChinaMobilePeertoPeerprotocol,中國(guó)移動(dòng)點(diǎn)對(duì)點(diǎn)協(xié)議

IMAP4InternetMessageAccessProtocolversion4

POP3PostOfficeProtocolversion3

RADIUSRemoteAuthenticationDialInUserService

WWWWorldWideWeb

GSMGlobalSystemforMobileCommunications全球移動(dòng)通信系統(tǒng)

XMLextensibleMarkupLanguage,可擴(kuò)展標(biāo)記語(yǔ)言

4接口命名范例

接口名稱采取單詞首字母大寫，其他字母小寫的方法?？s略語(yǔ)中的字母都大寫。消息內(nèi)容界說(shuō)中，

根本數(shù)據(jù)類型的字段命名范例采取單詞首字母大寫，單詞間沒(méi)有連接符的方法。對(duì)用Schema界說(shuō)的字

段在單詞間加二連接符。

5接口在網(wǎng)絡(luò)中的位置

DSMP在整個(gè)數(shù)據(jù)業(yè)務(wù)框架中處于核心職位，它是數(shù)據(jù)業(yè)務(wù)的底子設(shè)施?？紤]到數(shù)據(jù)業(yè)務(wù)需求特點(diǎn):

數(shù)據(jù)業(yè)務(wù)需求變革快，應(yīng)用的多樣化、本性化需求高，應(yīng)用的實(shí)效性要求很高，同時(shí)中國(guó)移動(dòng)不可能提

供所有的應(yīng)用，需要和第三方配合。就要求DSMP具有高可靠性、靈活的擴(kuò)展能力。

結(jié)構(gòu)圖如下：

承載網(wǎng)絡(luò)GPRS/CSD/WAPGW/SMSC

服務(wù)提供商SP|終端用戶

應(yīng)用APP終端應(yīng)用APP

6系統(tǒng)接口描述

6.1DSMP對(duì)外接口描述

DSMP和外部實(shí)體之間的接口如下圖所示:

V...?信令流

管理流

我們下面描述一下本范例需要界說(shuō)的接口：

Sg接口：DSMP與業(yè)務(wù)網(wǎng)關(guān)、SP署理、應(yīng)用平臺(tái)、PORTAL之間的接口，DSMP通過(guò)該接口為業(yè)務(wù)網(wǎng)

關(guān)、SP署理、應(yīng)用平臺(tái)、PORTAL提供數(shù)據(jù)業(yè)務(wù)治理平臺(tái)的用戶和SP的相關(guān)資源。

Sb接口：DSMP與BOSS系統(tǒng)的接口，該接口實(shí)現(xiàn)DSMP與BOSS系統(tǒng)之間的用戶及業(yè)務(wù)信息同步、

話單通報(bào)、鑒權(quán)、客戶治理、統(tǒng)一賬戶成果。

SScp接口：DSMP與SCP的接口，DSMP通過(guò)該接口實(shí)現(xiàn)移動(dòng)預(yù)付用度戶的實(shí)時(shí)扣費(fèi)。

Sk接口：DSMP與客服/1860的接口。

Sim接口：DSMP之間的接口，DSMP之間通過(guò)該接口用戶的根本數(shù)據(jù)和訂購(gòu)干系及全網(wǎng)SP及辦事的

相關(guān)信息的同步。

Ma接口：DSMP與SP之間的接口，DSMP通過(guò)該接口進(jìn)行訂購(gòu)干系同步和在用戶自助辦事時(shí)設(shè)置于訂

購(gòu)辦事相關(guān)的屬性。

6.2接口消息實(shí)現(xiàn)

DSMP接口格式采取基于HTTP的SOAP協(xié)議，以WebService的方法進(jìn)行相互之間的通信，要

求HTTP的版本為1.1以上。DSMP接口的WEBSERVICE具體界說(shuō)請(qǐng)參看附件C和D。

7字段類型說(shuō)明

integer：十進(jìn)制的整數(shù)型。

unsignedinteger：十進(jìn)制的無(wú)標(biāo)記整數(shù)型。

string：由char組成的字符串

binary：由byte組成的字符串，由于XML不能直接承載二進(jìn)制數(shù)據(jù)，所以對(duì)該類型的數(shù)據(jù)采取

BASE64編碼。

8DSMP接口界說(shuō)

8.1DSMP與業(yè)務(wù)網(wǎng)關(guān)之間的接口（Sg接口）

8.2DSMP與BOSS系統(tǒng)接口（Mb接口）

8.3DSMP與SCP接口（Sscp接口）

8.4DSMP與客服/1860之間的接口（Sk接口）

8.5DSMP之間的接口（Sim接口）

8.6DSMP與SP之間的接口（Ma接口）

DSMP通過(guò)該接口將訂購(gòu)干系同步給SP,具體接口消息拜見(jiàn)下表。

在用戶自助辦事時(shí)，如果在用戶訂購(gòu)辦事時(shí)需要設(shè)置與該辦事相關(guān)的屬性，則通過(guò)該接口修改于辦

事相關(guān)的屬性。該接口是通過(guò)連接實(shí)現(xiàn)的。

8.6.1DSMP與SP之間接口消息界說(shuō)

消息名稱消息描述

SyncOrderRelationReq訂購(gòu)干系同步消息

SyncOrderRelationResp訂購(gòu)干系同步應(yīng)答消息

8.6.2DSMP與SP之間接口消息體界說(shuō)

訂購(gòu)干系同步消息接口消息界說(shuō)（SyncOrderRelationReq）

.1成果描述

此接口在DSMP因?yàn)槟撤N情況更新了用戶訂購(gòu)干系（包羅訂購(gòu)、取消、暫停、激活）的時(shí)候，通過(guò)

此接口提倡和SP的更新訂購(gòu)干系的交互。

消息名消息類型消息偏向

SyncOrderRelationReqRequestDSMP^SP

SyncOrderRelationRespResponseSP^DSMP

8.6?2.1.2接口內(nèi)容描述

SyncOrderRelationReq消息字段描述:

返回界說(shuō)重要性類型說(shuō)明

MsgType必須string消息類型

TransactionID必須string該消息編號(hào)

Version必須string該接口消息的版本號(hào)，本次所有

的接口消息的版本都為“150”

Send_Address必須addressinfoschema發(fā)送方的地點(diǎn)

Dest_Address必須addressinfoschema吸收方的地點(diǎn)

FeeUserJD必須useridschema計(jì)用度戶標(biāo)識(shí)

DestUserJD必須useridschema使用用戶標(biāo)識(shí)

LinkID可選string臨時(shí)訂購(gòu)干系的事務(wù)ID

ActionlD必須integer辦事?tīng)顟B(tài)治理行動(dòng)代碼，具體值

如下：

1:開(kāi)通辦事；

2：停止辦事；

3：激活辦事；

4：暫停辦事；

ActionReasonlD必須integer產(chǎn)生辦事?tīng)顟B(tài)治理行動(dòng)原因的代

碼，具體值如下：

1：用戶提倡行為

2：Admin&1860提倡行為

3：Boss停機(jī)

4：Boss開(kāi)機(jī)

5：Boss過(guò)戶

6：Boss銷戶

7：Boss改號(hào)

8：扣費(fèi)失敗導(dǎo)致的辦事取消

9：其他

SPID可選stringSP的企業(yè)代碼

SPServicelD必須stringSP中該辦事的辦事代碼

AccessMode可選Integer辦事的訪問(wèn)方法

1：WEB

2：WAP

3：SMS

FeatureStr可選binary辦事訂購(gòu)參數(shù)

SyncOrderRelationResp消息字段描述:

字段名重要性類型說(shuō)明

MsgType必須string消息類型

TransactionID必須string該消息編號(hào)

Version必須string該接口消息的版本號(hào)，本次所有

的接口消息的版本都為“150”

hRet必須integer返回值，詳細(xì)界說(shuō)見(jiàn)第9章

9返回值的統(tǒng)一界說(shuō)

在HTTP通信時(shí)的狀態(tài)碼請(qǐng)拜見(jiàn)HTTP/1.1協(xié)議中規(guī)定的狀態(tài)碼值，不包羅在本范例的返回值統(tǒng)一

界說(shuō)中。

具體描述如下：

0：樂(lè)成

1：未知錯(cuò)誤

2-99：保存

100-999為業(yè)務(wù)網(wǎng)關(guān)和DSMP之間的接口消息中的錯(cuò)誤代碼，如下：

100：手機(jī)號(hào)碼不存在

101：手機(jī)號(hào)碼錯(cuò)誤

102：用戶停機(jī)

103：用戶欠費(fèi)

104:用戶沒(méi)有使用該業(yè)務(wù)的權(quán)限

105：業(yè)務(wù)代碼錯(cuò)誤

106辦事代碼錯(cuò)誤

107業(yè)務(wù)不存在

108該業(yè)務(wù)暫停辦事

109該辦事種類不存在

110該辦事種類尚未開(kāi)通

111該業(yè)務(wù)尚未開(kāi)通

112SP代碼錯(cuò)誤

113SP不存在

114SP暫停辦事

115用戶沒(méi)有定購(gòu)該業(yè)務(wù)

116用戶暫停定購(gòu)該業(yè)務(wù)

117該業(yè)務(wù)不能對(duì)該用戶開(kāi)放

118：用戶已經(jīng)訂購(gòu)了該業(yè)務(wù)

119用戶不能取消該業(yè)務(wù)

120話單格式錯(cuò)誤

121沒(méi)有該類業(yè)務(wù)

122吸收異常

123業(yè)務(wù)代價(jià)為負(fù)

124業(yè)務(wù)代價(jià)格式錯(cuò)誤

125業(yè)務(wù)代價(jià)超出范疇

126該用戶不是神州行用戶

127該用戶沒(méi)有足夠的余額

128補(bǔ)款，沖正失敗

129用戶已經(jīng)是夢(mèng)網(wǎng)用戶

130用戶在BOSS中沒(méi)有相關(guān)用戶數(shù)據(jù)

131BOSS系統(tǒng)數(shù)據(jù)同步墮落

132相關(guān)信息不存在

133用戶數(shù)據(jù)同步墮落

134SP數(shù)據(jù)同步墮落

135業(yè)務(wù)數(shù)據(jù)同步墮落

136：用戶密碼錯(cuò)誤

137：偽碼信息錯(cuò)誤

138：用戶相關(guān)信息不存在

DSMP和SCP之間的接口消息中的錯(cuò)誤代碼界說(shuō)如下:

200：正常應(yīng)答

205：注冊(cè)樂(lè)成

206：注冊(cè)不樂(lè)成

207：注銷樂(lè)成

208：注銷失敗

209：無(wú)臨時(shí)話單

400：辦事器端無(wú)法理解請(qǐng)求CMPP包

401：用戶未被認(rèn)證，應(yīng)答包中包羅Authenlicate,要用戶認(rèn)證

413：請(qǐng)求實(shí)體太長(zhǎng)

414：夢(mèng)網(wǎng)內(nèi)部實(shí)體間的XML消息體錯(cuò)誤

415：SP發(fā)給GW的XML消息體錯(cuò)誤

500：辦事器的內(nèi)部處理懲罰31落

501：辦事器忙，拒絕請(qǐng)求

502：GW與SCP的連接中斷，拒絕請(qǐng)求

505：版本號(hào)不支持

506：辦事器方超時(shí)

4000-4999為DSMP與SP之間的接口消息中的錯(cuò)誤代碼:

4000：無(wú)效的msglype

4001：無(wú)效的action_id；

4002：無(wú)效的action_reasonid；

4003：無(wú)效的SPID

4004：無(wú)效的servicelD

4005：無(wú)效的pseudocode

4006：無(wú)效的accessmode

4007：MISC同步開(kāi)通辦事，但SP端已存在訂購(gòu)干系,且狀態(tài)為開(kāi)通

4008：MISC同步開(kāi)通辦事，且SP端不存在訂購(gòu)干系，但開(kāi)通辦事失敗

4009：MISC同步開(kāi)通辦事，但SP端已存在訂購(gòu)干系，且狀態(tài)為暫停

4010：MISC同步停止辦事，且SP端存在訂購(gòu)干系，但取消辦事失敗

4011：MISC同步停止辦事，但SP端不存在訂購(gòu)干系

4012：MISC同步暫停辦事，且SP端存在訂購(gòu)干系，但暫停辦事失敗

4013：MISC同步暫停辦事，但SP端不存在訂購(gòu)干系

4014：MISC同步暫停辦事，但SP端已存在訂購(gòu)干系，且狀態(tài)為暫停

4015：MISC同步激活辦事，但SP端已存在訂購(gòu)干系，且狀態(tài)為開(kāi)通

4016：MISC同步激活辦事，但SP端不存在訂購(gòu)干系

4017：M1SC同步激活辦事，且SP端存在訂購(gòu)干系，但激活辦事失敗

9000-9999為系統(tǒng)級(jí)錯(cuò)誤:

9000：系統(tǒng)磁盤讀寫錯(cuò)誤

9001：網(wǎng)絡(luò)異常

9002：網(wǎng)絡(luò)錯(cuò)誤

9003：業(yè)務(wù)網(wǎng)關(guān)忙，業(yè)務(wù)網(wǎng)關(guān)緩存

9004：業(yè)務(wù)網(wǎng)關(guān)忙，并且業(yè)務(wù)網(wǎng)關(guān)緩沖區(qū)滿，DSMP緩存，并暫時(shí)不要發(fā)送消息，期待一段時(shí)間重試。

9005：DSMP忙，DSMP緩存

9006：DSMP忙，并且DSMP緩沖區(qū)滿，業(yè)務(wù)網(wǎng)關(guān)緩存，并暫時(shí)不要發(fā)送消息，期待一段時(shí)間重試。

9007：業(yè)務(wù)網(wǎng)關(guān)凌駕限制的流量

9008：DSMP異常，并不可用

9009：業(yè)務(wù)網(wǎng)關(guān)異常，并不可用

9010：該業(yè)務(wù)網(wǎng)關(guān)沒(méi)有權(quán)限調(diào)用該接口消息

9011：DSMP沒(méi)有權(quán)限發(fā)送該接口消息給業(yè)務(wù)網(wǎng)關(guān)

9012：版本不支持

9013：消息類型不對(duì)，系統(tǒng)不支持

9014：驗(yàn)證錯(cuò)誤，無(wú)法解析SOAP和XML結(jié)構(gòu)、缺少必須存在的字段，大概消息格式不正確

9015：拒絕消息，辦事器無(wú)法完成請(qǐng)求的辦事

10體例歷史

版本號(hào)更新時(shí)間主要內(nèi)容或重大修改

1.0.02003年1月1.0.0版本

1.5.02003年4月1.5.0版本

附錄A模式（schema）描述

Schema字段描述

address_info_schema（地點(diǎn)信息）

字段名稱字段類型字段描述

DeviceTypeinteger設(shè)備類型

0：DSMP

100：ISMG

101：WAPSPPROXY

1XX：其他業(yè)務(wù)網(wǎng)關(guān)

200：WAPPORTAL

201：WWWPORTAL

202：VOICEPORTAL

203：PDAPORTAL

2XX：其他門戶

300：MMSC

301：KJAVASERVER

302：LSP

3XX：其它應(yīng)用平臺(tái)

400：SP

DevicelDstring設(shè)備編號(hào)，設(shè)備編號(hào)采取各設(shè)

備的入網(wǎng)編號(hào)，例如短信網(wǎng)關(guān)

使用網(wǎng)關(guān)ID、對(duì)SP使用其企

業(yè)代碼，該設(shè)備編號(hào)由DSMP

分派，并且在同一設(shè)備類型中

該編號(hào)唯一

userJd_schema（用戶標(biāo)識(shí)）

字段名稱字段類型字段描述

UserlDTypeinteger用戶標(biāo)識(shí)類型

1:用手機(jī)號(hào)標(biāo)識(shí)

2：用偽碼標(biāo)識(shí)

3：兩者同時(shí)標(biāo)識(shí)

MSISDNstring用戶手機(jī)號(hào)

PseudoCodebinary用戶偽碼

附錄BDSMP與SCP之間通信協(xié)議中共用的通用元素的界說(shuō)

附錄CDSMP平臺(tái)WebServices數(shù)據(jù)類型界說(shuō)

<?xmlversion=n1.O'*encoding=HUTF-8H?>

<schematargetNamespace=nhttp://www.monternet.com/dsmp/schemas'1

xmlns:wsdl=nhttp://schemas.xmlsoap.org/wsdl/',

xmlns:soapenc=nhttp://schemas./soap/encoding/',

xmlns:dsmp=n/dsmp/schemasn

xmlns=,,http://www.w3.org/2001/XMLScheman>

<complexTypename=nadciress_info_scheman>

<sequence>

<elementname=nDeviceType**type=ninteger"/>

<elementname=nDevicelDHtype=nstring'1/>

</sequence>

</complexType>

<complexTypename=nuser_id_schemaH>

<sequence>

<elementname=nUserIDTypeHtype=nintegern/>

<elementname=nMSISDNHtype=nstringH/>

<elementname=nPseudoCodeHtype=ubase64Binaryu/>

</sequence>

</complexType>

<!—

########################################################################->

<elementname=nTransactionIDntype=nstringn/>

<elementname=nSyncOrderRelationReqn

type=*'dsmp:SyncOrderRelationReqTypeH/>

<complexTypename=,,SyncOrderRelationReqType,,>

<sequence>

<elementname=nMsgTypentype=nstring*'/>

<elementname="Version"type=nstringn/>

<elementname="Send_Address”

type=,,dsmp:address_info_scheman/>

<elementname=nDest_Addressn

type=ndsmp:address_info_scheman/>

<elementname=nFeeUser_IDntype=ndsmp:user_id_scheman/>

<elementname=nDestUser_IDntype=ndsmp:user_id_scheman/>

<elementname=nLinkIDHtype=nstringHminOccurs=n0n/>

<elementname=nActionIDHtype=nintegern/>

<elementnarne=nActionReasonIDHtype=nintegern/>

<elementname=nSPIDntype=nstringnminOccurs=nOH/>

<elementname=nSPServiceIDntype=nstringn/>

<elementname=nAccessModeHtype=nintegernminOccurs=nOn/>

<elementname=nFeatureStr**type=nbase64Binaryn

minOccurs=nOH/>

〈/sequence〉

</complexType>

<elementname=nSyncOrderRelationRespn

type=ndsmp:SyncOrderRelationRespType',/>

<complexTypename=nSyncOrcierRelationRespTypen>

<sequence>

<elementname=nMsgTypentype=,,stringn/>

<elementname="Version"type=nstringn/>

<elementname=nhRetutype=nintegern/>

</sequence>

</complexType>

</schema>

附錄DDSMP平臺(tái)WebServices接口界說(shuō)和SOAP綁定

1DSMP平臺(tái)WebService接口設(shè)計(jì)和開(kāi)發(fā)準(zhǔn)則

DSMP范例中的所有WebService接口依據(jù)W3C組織頒布的WebServicesDescription

Language(WSDL)1.1(2001/03/15)范例而設(shè)計(jì)和界說(shuō)，并與WSDL標(biāo)準(zhǔn)后續(xù)版本中的相關(guān)規(guī)定

的保持一致性。所有采取DSMP范例的產(chǎn)物的接口設(shè)計(jì)和開(kāi)發(fā)應(yīng)遵守以下原則：

?接口中的所有消息及相關(guān)數(shù)據(jù)類型的XML模式界說(shuō)均應(yīng)采取由本范例提供的XML模式界說(shuō)，內(nèi)容

詳見(jiàn)附錄C。擺設(shè)WebService時(shí)，所有由DSMP界說(shuō)的XML模式界說(shuō)均被包羅在dsmp.xsd

文件中，并以公然的URL地點(diǎn)被引用。在WSDL界說(shuō)中采取名為dsmp的命名空間來(lái)限定，在

WSDL界說(shuō)中為xmlns:dsmp="http:〃/dsmp/dsmp.xsd”,引用時(shí)采

取dsmp:前綴，例如，

<messagename="sg.UserRegisterReq">

<partname="UserRegisterInput"type="dsmp:UserRegisterReqType"/>

</message>

附錄為DSMP范例界說(shuō)「所有被引用到的類型和元素的命名空間及XML模式，此命名空間作用范

疇涵蓋所有WSDL接口消息。SOAP消息中命名空間的使用要領(lǐng)見(jiàn)第2節(jié)的舉例說(shuō)明。

?接口的WSDL界說(shuō)均應(yīng)采取本范例提供的WSDL界說(shuō)，內(nèi)容詳見(jiàn)本附錄的第3節(jié)。擺設(shè)Web

Service時(shí)，所有WSDL界說(shuō)內(nèi)容被包羅在dsmp.wsdl文件中，并以公然的URL被引用。憑據(jù)

WSDL標(biāo)準(zhǔn)的規(guī)定，本范例接口的WSDL界說(shuō)主要包羅如下部分：

?類型(Types)：本范例采取的是文件引用的要領(lǐng)，所有DSMP范例界說(shuō)的消息類型被包羅在

dsmp.xsd文件中；

?消息(Message)：即在調(diào)用歷程中產(chǎn)生的請(qǐng)求或響應(yīng)的SOAP封裝里的消息結(jié)構(gòu)；

?操縱(Operation)：被本范例界說(shuō)的WebService所支持的行動(dòng)的理論描述；

?端口類型(PortType)：被終端所支持的一套操縱的聚集的界說(shuō)；

?綁定(Binding)：即SOAP綁定的界說(shuō)部分，憑據(jù)WSDL1.1標(biāo)準(zhǔn)，端口類型被綁定到SOAP1.1

協(xié)議，因而，任何采取DSMP范例的產(chǎn)物，無(wú)論采取何種支持WebService的中間件平臺(tái)或

SOAP專用步伐來(lái)實(shí)現(xiàn)WebService接口，或是調(diào)用WebService接口，均應(yīng)支持對(duì)

SOAP1.1的綁定。例如對(duì)調(diào)用者而言，只有向辦事器端發(fā)送標(biāo)準(zhǔn)的SOAP封裝消息包，才華

得到正確的返回，不然均被視作調(diào)用格式錯(cuò)誤；

?端口(Port)：即實(shí)現(xiàn)接口的步伐的網(wǎng)絡(luò)地點(diǎn)的界說(shuō)：

?辦事(Service)：即實(shí)現(xiàn)接口的一系列端口集。

?SOAP綁定原則

本范例界說(shuō)的WebService接口與SOAP1.1協(xié)議格式相綁定，所有請(qǐng)求和響應(yīng)消息均應(yīng)采取

SOAP格式的消息封裝，包羅SOAP封套(Envelope),SOAP包頭(Header)和SOAP包體(Body)

三部分?對(duì)任何技能實(shí)現(xiàn)的調(diào)用者而言，發(fā)出的調(diào)用請(qǐng)求消息均須帶有以上三部分內(nèi)容，包頭和包

體消息結(jié)構(gòu)中引用的類型均來(lái)自dsmp.xsd中的界說(shuō)。但在SOAP包體中，如果憑據(jù)范例界說(shuō)某

一參數(shù)為可選，則SOAP消息中可不包羅標(biāo)識(shí)該參數(shù)的元素。返回的SOAP消息結(jié)構(gòu)同請(qǐng)求消息;

?在本范例中，為支持事物處理懲罰而界說(shuō)的TransactionlD參數(shù)被包羅在SOAP包頭中傳送，因

而，本范例要求所有SOAP消息均必須帶有SOAP包頭，接口步伐應(yīng)憑據(jù)需要對(duì)SOAP包頭中的

Transactions做相應(yīng)的處理懲罰（用來(lái)標(biāo)識(shí)事物或忽略）?TransactionlD的產(chǎn)生規(guī)矩是

DeviceID+10位的數(shù)字，該10位數(shù)字從1開(kāi)始，并且不敷10位的前補(bǔ)0。每次增長(zhǎng)的步長(zhǎng)為1,

依次循環(huán)使用。

?本范例遵循WSDL標(biāo)準(zhǔn)，接口通訊層與HTTP1.1協(xié)議的POST和GET綁定在一起。按本范例規(guī)

定，辦事器和客戶端之間均通過(guò)HTTP的POST要領(lǐng)來(lái)進(jìn)行交互。與此相關(guān)，HTTP報(bào)文內(nèi)容格式

與MIME格式綁定，例如Content-Type為text/xml等均遵循MIME標(biāo)準(zhǔn)。

?本范例中的WSDL和XSD里所界說(shuō)的URI并非普遍適用，在實(shí)際擺設(shè)的WebService平臺(tái)產(chǎn)物

中應(yīng)被修改為真實(shí)可用的URL例如本范例中大量界說(shuō)的用來(lái)定位WebService辦事的URI為

''http://www.monternet.com/dsmp/dsmp.WSDL該URI僅適用于一產(chǎn)業(yè)物，其

他業(yè)務(wù)網(wǎng)關(guān)上擺設(shè)的WebService就應(yīng)采取與其相適用的URL

2舉例說(shuō)明

本節(jié)以AuthPrice接口為例，來(lái)具體說(shuō)明接口的SOAP綁定和調(diào)用規(guī)矩。本接口典范是基于

WebLogic平臺(tái)，用Java語(yǔ)言編程實(shí)現(xiàn)。必須注意，此例中的參數(shù)值無(wú)實(shí)際意義。SOAP請(qǐng)求和響應(yīng)

消息如下：

SOAP請(qǐng)求消息：

POST/dsmp/dsmp.wsdlHTTP/1.1

Host:

Content-Type:text/xml;charset=utf-8

Content-Length:length

SoapAction:nsg.AuthPrice"

<?xmlversion=nl.0nencoding=nutf-8M?>

<S0AP-ENV:Envelopexmlns:xsi="/2001/XMLSchema-instanceH

xmlns:xsd=nhttp://www.w3.org/2001/XMLScheman

xmlns:SOAP-ENV=n/soap/envelope/n

xmlns:SOAP-ENC="/soap/encoding/H>

<S0AP-ENV:Header〉

<TransactionIDxmlns="http://www.monternet.com/dsmp/schemas/n>

110000000001

</TransactionID>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<AuthPriceReqxmlns=H/dsmp/schemas/">

<Version>1.5.0</Version>

<MsgType>String</MsgType>

<Send_Address>

<DeviceType>O</DeviceType>

<DeviceID>ll</DeviceID>

</Send_Address>

<Dest_Address>

<DeviceType>O</DeviceType>

<DeviceID>ll</DeviceID>

</Dest_Address>

<MsgID>String</MsgID>

<FeeUser_ID>

<UserIDType>O</UserIDType>