【文章內(nèi)容簡(jiǎn)介】 TTP的包頭里面的表示為：“ContentType: text/plain”，請(qǐng)注意，在包頭里，相關(guān)的限制和約定以HTTP及XML協(xié)議為準(zhǔn)。MISC命令交互中Http請(qǐng)求和響應(yīng)體中的XML格式如下：?xml version=“” ?misc_mand version=”” mand_namemand_name/mand_name mand_data_block data_tag1data1/data_tag1 data_tag2data2/data_tag2…… /mand_data_block/misc_mand說(shuō)明：XML 元素類 型意 義說(shuō) 明misc_mandMISC命令請(qǐng)求標(biāo)志，MISC命令請(qǐng)求XML包的根標(biāo)記（Root Tag）。所有MISC命令內(nèi)容必須位于此標(biāo)注中version為本接口規(guī)范版本號(hào)mand_name字符串MISC命令名稱。其值可能為： provision。 provision_response。 sso。 sso_response。 等等在同一個(gè)包中只有一個(gè)命令。mand_data_blockdata_tag子元素?cái)?shù)組MISC命令數(shù)據(jù)塊，所有MISC命令數(shù)據(jù)項(xiàng)必須置于此塊內(nèi)。data_tag隨命令定義MISC命令數(shù)據(jù)項(xiàng)此標(biāo)注數(shù)量、名稱和元素類型均據(jù)命令不同來(lái)定義3) Http響應(yīng)中命令結(jié)果值約定通常的MISC命令交互中，在Http響應(yīng)體中，一個(gè)XML數(shù)據(jù)包反映了命令處理結(jié)果。在該XML數(shù)據(jù)包中，通常包含一個(gè)result_id（或者是其他Tag名）元素，該元素表示此次MISC命令交互是否完成。result_id用一個(gè)整數(shù)值來(lái)表示命令處理結(jié)果。通常，“0”表示命令成功；其他任何數(shù)值均表示命令失??；在需要的情況下，可以用特定的數(shù)值（一般用負(fù)數(shù)）表示與該命令有關(guān)的一個(gè)特定的錯(cuò)誤類型。如下是一個(gè)命令結(jié)果表示規(guī)則示例：result_id = 0： 命令處理成功；result_id = 1： 命令處理失敗。失敗原因：無(wú)效的spid；result_id = 2： 命令處理失敗。失敗原因：無(wú)效的sppassword；result_id = 3： 命令處理失敗。失敗原因：無(wú)效的sid；result_id = 4（或其他任何值）： 命令處理失敗。失敗原因：其他未知原因錯(cuò)誤。3 應(yīng)用程序接口規(guī)范 業(yè)務(wù)狀態(tài)管理接口 業(yè)務(wù)狀態(tài)管理流程示意圖 使用實(shí)例服務(wù)狀態(tài)管理接口用于在MISC中用戶對(duì)某個(gè)夢(mèng)網(wǎng)服務(wù)的使用狀態(tài)發(fā)生改變時(shí)，MISC與夢(mèng)網(wǎng)服務(wù)間同步服務(wù)狀態(tài)。用戶對(duì)夢(mèng)網(wǎng)服務(wù)的使用狀態(tài)改變包括開通服務(wù)、停止服務(wù)、暫停服務(wù)和激活服務(wù)等動(dòng)作。當(dāng)用戶在夢(mèng)網(wǎng)門戶中通過(guò)上述動(dòng)作改變了對(duì)某一個(gè)夢(mèng)網(wǎng)服務(wù)的使用狀態(tài)時(shí)，MISC內(nèi)部將記錄此服務(wù)狀態(tài)的改變，同時(shí)將此信息作為一個(gè)Http請(qǐng)求發(fā)送給該夢(mèng)網(wǎng)服務(wù)相應(yīng)的處理模塊。在請(qǐng)求中，MISC會(huì)向夢(mèng)網(wǎng)服務(wù)發(fā)出該用戶的夢(mèng)網(wǎng)用戶身份（MID）和服務(wù)狀態(tài)動(dòng)作。該夢(mèng)網(wǎng)服務(wù)相應(yīng)的處理模塊應(yīng)該接收并處理該請(qǐng)求，并做出正確的響應(yīng)。通常該夢(mèng)網(wǎng)服務(wù)應(yīng)該根據(jù)請(qǐng)求中的內(nèi)容，相應(yīng)修改自己的用戶表，在下次用戶訪問該夢(mèng)網(wǎng)服務(wù)時(shí)，服務(wù)應(yīng)該依據(jù)這些內(nèi)容判斷該用戶是否可以合法使用。在響應(yīng)中夢(mèng)網(wǎng)服務(wù)應(yīng)通知MISC自己是否正確處理完畢。 接口說(shuō)明服務(wù)狀態(tài)管理是MISC與SP之間的一個(gè)單向命令交互。命令方向?yàn)镸ISC向SP發(fā)送命令交互Http/XML請(qǐng)求，SP處理后響應(yīng)此請(qǐng)求。以下假設(shè)某SP（SP1）的服務(wù)狀態(tài)管理的處理程序?yàn)槿缦耈RL：:// 用戶在MISC中申請(qǐng)開通SP1的Mail服務(wù)時(shí)，MISC將會(huì)向上述URL發(fā)出一個(gè)HTTP請(qǐng)求，在請(qǐng)求體中包含有XML格式的相關(guān)操作數(shù)據(jù)；SP收到此請(qǐng)求，進(jìn)行相應(yīng)業(yè)務(wù)處理后，響應(yīng)此請(qǐng)求，響應(yīng)體中同樣包含有XML格式的操作結(jié)構(gòu)數(shù)據(jù)。 Http請(qǐng)求XML數(shù)據(jù)包格式：?xml version = “” ?misc_mand version=”” mand_nameprovision/mand_name mand_data_block action_idaction_id/action_id service_idservice_id/service_id midmid/mid mobile_idmobile_id/mobile_id access_modeaccess_mode1/access_mode … … access_modeaccess_moden/access_mode /mand_data_block/misc_mand 說(shuō)明：XML Tag類 型意 義說(shuō) 明action_id整型服務(wù)狀態(tài)管理動(dòng)作代碼，具體值如下：1： 開通服務(wù)；2： 停止服務(wù)；3： 激活服務(wù)；4： 暫停服務(wù)；示例：action_id1/action_idservice_id整型欲處理服務(wù)的Service ID長(zhǎng)度為8位（在MISC系統(tǒng)中是“外碼”）mid字符串進(jìn)行此操作的MISC用戶的MID長(zhǎng)度為14位，編碼說(shuō)明請(qǐng)參閱附件mobile_id字符串用戶的手機(jī)號(hào)碼只要添加服務(wù)時(shí)指定該服務(wù)的認(rèn)證方式是手機(jī)號(hào)認(rèn)證，則手機(jī)號(hào)會(huì)被發(fā)送access_mode整型服務(wù)的訪問方式：1:Web。 2: Wap。 3: SMS。可以是一條或多條。注：如果SP沒有實(shí)現(xiàn)服務(wù)的暫停、激活或者其他的功能，用戶將無(wú)法使用該功能，MISC沒有專門的處理。 Http響應(yīng)XML數(shù)據(jù)包格式：?xml version = “” ?misc_mand version=”” mand_nameprovision_response/mand_name mand_data_block result_idresult_id/result_id result_stringresult_string/result_string /mand_data_block/misc_mand 說(shuō)明：XML Tag類 型意 義說(shuō) 明result_id整型服務(wù)狀態(tài)管理命令結(jié)果代碼。具體值如下：0： 命令成功；1：無(wú)效的action_id；2：無(wú)效的service_id； (其它任何非0值)： 命令失敗；result_string字符串服務(wù)狀態(tài)管理命令結(jié)果說(shuō)明字符串。 約定SP必須提供一個(gè)URL地址用于處理業(yè)務(wù)訂購(gòu)的同步過(guò)程，在SP申請(qǐng)注冊(cè)時(shí)就應(yīng)該提交這一個(gè)地址（如），并且在SP的測(cè)試階段，業(yè)務(wù)訂購(gòu)功能將作為一個(gè)重要的測(cè)試項(xiàng)目。 升級(jí)注意事項(xiàng)本接口是為了保證系統(tǒng)的兼容性而留下的，在新版的系統(tǒng)中，業(yè)務(wù)狀態(tài)接口已升級(jí)到WEB Service方式的接口，具體請(qǐng)參見《數(shù)據(jù)業(yè)務(wù)管理平臺(tái)接口規(guī)范SP分冊(cè)》。 單點(diǎn)認(rèn)證接口 單點(diǎn)認(rèn)證的流程示意圖單點(diǎn)認(rèn)證的完成如圖中粗線所示部分（細(xì)線為輔助說(shuō)明流程，簡(jiǎn)略），是由頁(yè)面訪問子接口、SSO驗(yàn)證子接口、Echo子接口等三個(gè)子接口組成。頁(yè)面訪問接口是指用戶從WAP Portal進(jìn)入SP的服務(wù)時(shí)的通過(guò)URL頁(yè)面?zhèn)鬟f參數(shù)的格式，以及用戶從SP返回到WAP Portal時(shí)所遵循的頁(yè)面規(guī)范。在MISC將用戶驗(yàn)證信息傳遞給SP、SP根據(jù)頁(yè)面訪問的接口獲取的用戶驗(yàn)證信息（SessionID、ServiceID）后向MISC發(fā)起SSO驗(yàn)證請(qǐng)求，同時(shí)附上SP的SP_id和密碼（SP申請(qǐng)業(yè)務(wù)接入時(shí)分配），MISC會(huì)給出請(qǐng)求結(jié)果，如果SessionID合法，同時(shí)會(huì)返回該SessionID對(duì)應(yīng)的用戶的MID/MSISDN。由于用戶的身份信息（MID）已經(jīng)在頁(yè)面訪問接口中傳遞給了SP，僅在特殊業(yè)務(wù)需要請(qǐng)求用戶的手機(jī)號(hào)碼時(shí)，SP才需要執(zhí)行此步操作，因此，該步驟是可選的，在流程示意圖中以虛線表示。SSO驗(yàn)證請(qǐng)求是SP對(duì)MISC的單向請(qǐng)求，請(qǐng)求對(duì)象為MISC的WAP Portal（URL地址在SP申請(qǐng)業(yè)務(wù)時(shí)分配），SSO請(qǐng)求一般在用戶訪問服務(wù)的入口處發(fā)生一次，SP也可多次發(fā)送SSO請(qǐng)求。Echo接口完成對(duì)用戶服務(wù)訪問的用戶的Session的維持。由于SessionID的時(shí)效性，為使用戶從SP處返回到MISC時(shí)會(huì)話仍然有效，SP需要定時(shí)向MISC發(fā)起Echo請(qǐng)求，以延長(zhǎng)用戶Session的存活期。Echo是SP對(duì)MISC的單向請(qǐng)求，請(qǐng)求對(duì)象為MISC的WAP Portal（URL地址在SP申請(qǐng)業(yè)務(wù)時(shí)分配），在用戶對(duì)SP訪問的期間多次發(fā)生，視具體使用情況而定。 頁(yè)面訪問子接口（1）使用實(shí)例在移動(dòng)夢(mèng)網(wǎng)門戶中，通過(guò)選中服務(wù)列表中的某一夢(mèng)網(wǎng)服務(wù)，夢(mèng)網(wǎng)用戶就可以通過(guò)MISC訪問到該夢(mèng)網(wǎng)服務(wù)的主頁(yè)，從而使用SP通過(guò)MISC提供的夢(mèng)網(wǎng)服務(wù)。在這個(gè)使用實(shí)例中，用戶并不需要知道該夢(mèng)網(wǎng)服務(wù)的主頁(yè)地址，MISC自動(dòng)向該夢(mèng)網(wǎng)服務(wù)發(fā)出首次主頁(yè)訪問請(qǐng)求，這就是頁(yè)面訪問接口。在這個(gè)首次服務(wù)主頁(yè)訪問請(qǐng)求中，除了SP的服務(wù)主頁(yè)地址和相關(guān)參數(shù)外，MISC同時(shí)會(huì)將用戶SID等有用的相關(guān)附加信息傳送給SP。利用這些附加信息，SP可以實(shí)現(xiàn)單點(diǎn)登錄以及其他功能。在一個(gè)典型的使用實(shí)例中，夢(mèng)網(wǎng)服務(wù)接收到該首次主頁(yè)訪問請(qǐng)求后，應(yīng)該按照如下處理流程進(jìn)行：178。 解析請(qǐng)求中的MISC_SessionID、MISC_ServiceID、 MISC_MID/MISC_Msisdn和MISC_AccessMode參數(shù)。MISC_SessionID 是該用戶在MISC中的臨時(shí)身份標(biāo)志（SID），夢(mèng)網(wǎng)服務(wù)應(yīng)該據(jù)此判斷該用戶是否有權(quán)使用本服務(wù)。MISC_AccessMode是該用戶的訪問模式，如果需要，服務(wù)可以據(jù)此做有針對(duì)性的處理。178。 一般情況下，MISC向用戶傳送MISC_MID，對(duì)于特殊業(yè)務(wù)的夢(mèng)網(wǎng)服務(wù)，需要獲得用戶的手機(jī)號(hào)碼，頁(yè)面訪問子接口將直接向夢(mèng)網(wǎng)服務(wù)傳送MISC_Msisdn而非MISC_MID。SP可以根據(jù)自身業(yè)務(wù)的需要，提交申請(qǐng)，要求系統(tǒng)對(duì)該業(yè)務(wù)傳送MID或Msisdn(手機(jī)號(hào)碼)178。 夢(mèng)網(wǎng)服務(wù)在自己的用戶表中判斷該夢(mèng)網(wǎng)用戶（MID）是否有權(quán)使用本服務(wù)。如果有權(quán)，夢(mèng)網(wǎng)服務(wù)即直接返回相應(yīng)的服務(wù)主頁(yè)；如果無(wú)權(quán)，夢(mèng)網(wǎng)服務(wù)應(yīng)該向夢(mèng)網(wǎng)用戶返回信息提示用戶進(jìn)行業(yè)務(wù)訂購(gòu)。在進(jìn)入夢(mèng)網(wǎng)服務(wù)主頁(yè)后，通常用戶后續(xù)的服務(wù)使用請(qǐng)求都將通過(guò)MISC的WTBS發(fā)出。所有的請(qǐng)求仍將攜帶SessionID。（2）頁(yè)面訪問接口流程示意圖 如圖中粗線所示部分（細(xì)線為輔助說(shuō)明流程，簡(jiǎn)略）（3）接口說(shuō)明頁(yè)面訪問是用戶每次訪問MISC注冊(cè)的SP服務(wù)時(shí)，MISC會(huì)將用戶的驗(yàn)證信息傳遞給SP，驗(yàn)證信息的傳遞采用在Http請(qǐng)求中的URL后附加MISC參數(shù)的形式。請(qǐng)求方向?yàn)镸ISC向SP發(fā)送服務(wù)頁(yè)面訪問請(qǐng)求，SP處理后響應(yīng)此請(qǐng)求，返回相應(yīng)頁(yè)面。以下假設(shè)某SP（SP1）的Mail服務(wù)的主頁(yè)地址為如下URL：[注意：大小寫敏感，本處純屬舉例]（4）Http請(qǐng)求Http請(qǐng)求URL格式：amp。MISC_AccessMode=0amp。MISC_ServiceID=010001000001amp。MISC_MID=09991234567890URL中MISC參數(shù)對(duì)說(shuō)明：XML Tag類 型意 義說(shuō) 明MISC_SessionID字符串 當(dāng)前用戶的Session編號(hào)MISC_SessionID的格式為不定長(zhǎng)（小于64位）的數(shù)字型不定長(zhǎng)字符串、格式為(MISCID)(Session Number): 如CentralMISC生成的MISC_SessionID為9991232342343452334524235….MISC_AccessMode字符串頁(yè)面類型標(biāo)志，目前有web/wap兩種。 MISC_ServiceID 字符串被請(qǐng)求的服務(wù)的編號(hào)長(zhǎng)度為8位，在SP申請(qǐng)業(yè)務(wù)接入時(shí)由運(yùn)營(yíng)商分配指定。MISC_MID字符串夢(mèng)網(wǎng)用戶的編號(hào)長(zhǎng)度為14位，詳細(xì)說(shuō)明見附件。說(shuō)明：因?yàn)镸ISC系統(tǒng)與SP之間進(jìn)行頁(yè)面交互時(shí)，會(huì)將MISC_SessionID、MISC_AccessMode、MISC_ServiceID、MISC_MID四個(gè)參數(shù)傳送給SP，在頁(yè)面的交互中，SP也有可能會(huì)在頁(yè)面接口中含有參數(shù)，所以，SP的應(yīng)用程序中應(yīng)該注意，不能使用上述同名的四個(gè)參數(shù)，否則會(huì)導(dǎo)致與MISC參數(shù)沖突而造成服務(wù)失敗。（5）Http響應(yīng)SP對(duì)頁(yè)面訪問請(qǐng)求的響應(yīng)內(nèi)容為本次請(qǐng)求的目標(biāo)頁(yè)面。SP響應(yīng)的頁(yè)面除用戶繼續(xù)訪問SP服務(wù)的鏈接地址外，還可能含有以下鏈接，用于用戶與MISC互動(dòng)：u “夢(mèng)網(wǎng)首頁(yè)”的鏈接，鏈接的URL為, xx為所接入省的代碼。如廣東MISC的夢(mèng)網(wǎng)首頁(yè)鏈接為：a href=””返回夢(mèng)網(wǎng)/a 或go href=””，MISC會(huì)在用戶點(diǎn)擊該鏈接后將用戶定位到用戶夢(mèng)網(wǎng)首頁(yè)。（注意：具體返回URL需要由運(yùn)營(yíng)商指定）u “返回上級(jí)”的鏈接，鏈接的URL為, xx為所接入省的代碼，如廣東MISC的返回上級(jí)的鏈接為：a href=”” 返回夢(mèng)網(wǎng)/a 或go href=””，MISC會(huì)在用戶點(diǎn)擊返回鏈接后將用戶定位到用戶離開夢(mèng)網(wǎng)時(shí)的位置。（注意：具體返回URL需要由運(yùn)營(yíng)商指定）u “取消訂購(gòu)”的鏈接，鏈接的URL為, xx為所接入省的代碼，如廣東MISC的返回上級(jí)的鏈接為：a href=”” 返回夢(mèng)網(wǎng)/a 或go href=””，MISC會(huì)在用戶點(diǎn)擊該鏈接時(shí)取消用戶正在訪問的該服務(wù)的訂購(gòu)關(guān)系。（6）約定SP注冊(cè)到移動(dòng)夢(mèng)網(wǎng)的業(yè)務(wù)中，URL地址格式為：://，含有前綴，如果所用服務(wù)端口不是標(biāo)準(zhǔn)的80，則請(qǐng)將端口加在URL后面，這時(shí)的URL格式應(yīng)該為：://。SP必須在其響應(yīng)的HTTP 包頭（Header）中包含charset：UTF8，否則網(wǎng)關(guān)傳送過(guò)程中會(huì)出現(xiàn)亂碼。SP響應(yīng)的WAP頁(yè)面不能使用WMLC格式，即SP端不要將WAP頁(yè)面進(jìn)行編譯。SP的夢(mèng)網(wǎng)服務(wù)應(yīng)對(duì)