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