【文章內(nèi)容簡(jiǎn)介】 16：MISC同步激活服務(wù),但SP端不存在訂購關(guān)系 　　其它錯(cuò)誤請(qǐng)參見《MISC系統(tǒng)短信SP接入指南－接口改造分冊(cè)》。 　　 　　正向訂購、取消包示例 　　 　　正向訂購請(qǐng)求包 　　 　　　　xmlns:SOAPENV= 　　xmlns:SOAPENC= 　　 　　xmlns:SOAPENC=　　xmlns:xsd= 　　xmlns:SOAPENV= 　　xmlns:SOAPENC= 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　 　　。 　　接口協(xié)議 HTTP協(xié)議 　　接口方向 請(qǐng)求：SP中央SSO平臺(tái) 　　響應(yīng)：中央SSO平臺(tái)SP 　　 　　查詢用戶信息接口請(qǐng)求的參數(shù)描述： 　　字段名稱 字段說明 　　ICPCode SP的企業(yè)代碼，長(zhǎng)度為6位，格式是9XYnnn,XY表示SP接入地的短信網(wǎng)關(guān)編號(hào)，nnn表示序列號(hào)。 　　ICPPassword SP的密碼，該字段要求使用統(tǒng)一的DES算法加密，并用SP的密碼作為加密算法的密鑰。 　　SeqNo SP用于標(biāo)識(shí)唯一一次認(rèn)證請(qǐng)求的號(hào)碼 　　RandomSessionKey 用戶的臨時(shí)會(huì)話標(biāo)識(shí) 　　 　　查詢用戶信息接口響應(yīng)的參數(shù)描述： 　　響應(yīng)中的BackURL上以[BackURL]?[參數(shù)名稱1]=[參數(shù)值1]amp。[參數(shù)名稱2]=[參數(shù)值2]的形式返回以下輸出參數(shù)： 　　字段名稱 字段說明 　　ResultID SSO平臺(tái)處理的結(jié)果，為0表示成功，其它表示失敗。失敗時(shí)將在ResultString字段將表示錯(cuò)誤信息。 　　失敗時(shí)不返回PseudoCode和MSISDN字段。 　　ResultString ResultIDid為0時(shí)，內(nèi)容為”O(jiān)K”。 　　失敗時(shí)將在本字段表示具體失敗原因。 　　SeqNo SP用于標(biāo)識(shí)唯一一次認(rèn)證請(qǐng)求的號(hào)碼。 　　PseudoCode 用戶偽碼 　　要求可以配置成：當(dāng)響應(yīng)包中有MSISDN字段時(shí)，填或不填該字段。即當(dāng)不填MSISDN時(shí)，此字段為必填 　　項(xiàng)；當(dāng)響應(yīng)包中有MSISDN字段時(shí)，則根據(jù)配置決定響應(yīng)包中是否需要該字段。 　　MSISDN 用戶手機(jī)號(hào)碼（要求能維護(hù)一個(gè)icp列表，對(duì)列表中有的icp才填該字段，否則，響應(yīng)包中不包含該字段） 　　AreaID 用戶的歸屬地ID。 　　定義與用戶登錄接口響應(yīng)信息中定義的AreaID一樣。 　　OtherInfoNumber 返回包中Other_Info的個(gè)數(shù)。 　　Other_Info是為了今后能夠靈活擴(kuò)展接口中傳遞的信息而定義的數(shù)據(jù)類型。 　　本字段表明在該XML包中存在的Otner_Info的數(shù)目。 　　Other_Info[] 表示其他信息數(shù)據(jù)。 　　OtherInfoNumber等于多少，在該XML包中就有多少個(gè)Other_Info。 　　在Other_Info的結(jié)構(gòu)中，包含兩個(gè)字段： 　　InfoCode：表示信息代碼 　　InfoValue：表示具體的信息值 　　 　　用戶訂購業(yè)務(wù)與點(diǎn)播下載業(yè)務(wù)的處理流程 　　? SP接入MISC平臺(tái)的實(shí)施說明 　　由于MISC平臺(tái)的建設(shè)有一個(gè)由點(diǎn)到面，逐步鋪開的過程，因此在實(shí)施訂購接口時(shí)需要考慮對(duì)于沒有接入MISC的服務(wù)如何與已接入MISC的服務(wù)區(qū)別對(duì)待的問題。 　　根據(jù)服務(wù)接入MISC的情況不同，會(huì)有以下幾種情況： 　　1）服務(wù)在MISC單點(diǎn)接入的情況 　　2）服務(wù)不在MISC接入的情況 　　3）服務(wù)多點(diǎn)接入時(shí)，主接入點(diǎn)和分接入點(diǎn)都接入MISC的情況 　　4）服務(wù)多點(diǎn)接入時(shí)，主接入點(diǎn)接入MISC，而分接入點(diǎn)沒有接入MISC的情況 　　 　　? 需要特別說明的是，在實(shí)現(xiàn)訂購功能時(shí)，SP需要根據(jù)服務(wù)接入地選擇SSO平臺(tái)，即訂購請(qǐng)求鏈接需要指向服務(wù)接入地的SSO平臺(tái)，對(duì)于多點(diǎn)接入業(yè)務(wù)，則指向服務(wù)主接入地的SSO平臺(tái)；如果服務(wù)接入地沒有建設(shè)SSO平臺(tái)，則指向中央SSO平臺(tái)。 　　 　　SSO訂購、點(diǎn)播接口定義 　　業(yè)務(wù)訂購與下載接口 　　接口名稱 業(yè)務(wù)訂購與下載 　　接口描述 SSO平臺(tái)向SP系統(tǒng)開放的用戶業(yè)務(wù)訂購和下載功能接口，本接口根據(jù)參數(shù)的不同，有兩種不同的用途： 　　1) 完成業(yè)務(wù)訂購、取消訂購、激活訂購和暫停訂購等操作 　　2) 完成下載類業(yè)務(wù)的臨時(shí)訂購，并返回臨時(shí)訂購關(guān)系ID 　　接口協(xié)議 HTTP協(xié)議 　　接口方向 請(qǐng)求：SP中央SSO平臺(tái) 　　響應(yīng)：中央SSO平臺(tái)SP 　　 　　業(yè)務(wù)訂購與下載接口請(qǐng)求的參數(shù)描述： 　　字段名稱 字段說明 　　ICPCode SP的企業(yè)代碼，長(zhǎng)度最長(zhǎng)為6位，格式是9XYnnn,XY表示SP接入地的短信網(wǎng)關(guān)編號(hào)，nnn表示序列號(hào)。 　　ICPServID SP提供的短信業(yè)務(wù)的業(yè)務(wù)代碼，變長(zhǎng)（小于等于10位）的字符串。 　　如果是批量訂購，則該字段可能包括多個(gè)業(yè)務(wù)代碼，多個(gè)業(yè)務(wù)代碼之間用逗號(hào)（“,”）分隔。 　　SeqNo SP用于標(biāo)識(shí)唯一一次認(rèn)證請(qǐng)求的號(hào)碼。 　　ItemID 用于標(biāo)識(shí)SP的即時(shí)下發(fā)類業(yè)務(wù)（鈴聲、圖片等）唯一性的標(biāo)識(shí)，長(zhǎng)度及格式由SP自行約定，應(yīng)只包含數(shù)字 　　和ASCII字符。 　　本字段只對(duì)下載業(yè)務(wù)有效，即只有當(dāng)ActionID為10時(shí)才需要，ActionID為其他值時(shí)參數(shù)中不應(yīng)包含本字段 　　。 　　例如，如果用戶訂購的是天氣預(yù)報(bào)、新聞等包月服務(wù)，則不需要帶此參數(shù)。 　　MSISDN 用戶在SP網(wǎng)站上輸入的手機(jī)號(hào)碼（此參數(shù)為可選參數(shù)） 　　ActionID 標(biāo)識(shí)用戶的操作，如訂購、取消訂購、暫停、激活等，長(zhǎng)度為2位的整數(shù)，取值區(qū)間： 　　1：訂購服務(wù)；2：取消服務(wù)； 　　3：激活服務(wù)；4：暫停服務(wù)； 　　10：點(diǎn)播下載服務(wù)。 　　BackURL 處理完成后要求SSO平臺(tái)重定向用戶到的目的URL。 　　DeliverURL SP的服務(wù)下發(fā)請(qǐng)求接口地址。 　　該參數(shù)為可選參數(shù)，當(dāng)訂購?fù)瓿珊骃P需要向用戶下發(fā)服務(wù)時(shí)填寫該參數(shù)（ActionID＝10時(shí)）。 　　當(dāng)訂購?fù)瓿珊筮€需要向用戶下發(fā)服務(wù)時(shí)，SSO平臺(tái)將向該參數(shù)定義的地址發(fā)起一個(gè)HTTPGET請(qǐng)求，以通 　　知SP向用戶下發(fā)指定的服務(wù)，請(qǐng)求中攜帶的參數(shù)格式參見服務(wù)下發(fā)請(qǐng)求接口。 　　 　　 　　? SSO訂購、點(diǎn)播接口定義 　　? 業(yè)務(wù)訂購與下載接口響應(yīng)的參數(shù)描述： 　　響應(yīng)中的BackURL以[BackURL]?[參數(shù)名稱1]=[參數(shù)值1]amp。[參數(shù)名稱2]=[參數(shù)值2]的形式返回以下輸出參數(shù)： 　　字段名稱 字段說明 　　ActionID 標(biāo)識(shí)用戶的操作，如訂購、取消訂購、暫停、激活等，長(zhǎng)度為2位的整數(shù)，取值區(qū)間：參見上表。 　　ResultID SSO平臺(tái)處理的結(jié)果，0表示成功，其它表示失敗。 　　失敗時(shí)不返回ResultString字段。 　　如果是批量訂購，則該字段中包含多個(gè)返回碼，多個(gè)返回碼之間用逗號(hào)（“,”）分隔，分別對(duì)應(yīng)批 　　量訂購中的每個(gè)服務(wù)。 　　例如，如果批量訂購3個(gè)業(yè)務(wù)，第1和第2個(gè)服務(wù)訂購成功，第3個(gè)服務(wù)由于服務(wù)代碼錯(cuò)誤訂購失敗 　　，則該字段的值為0,0,4110。 　　ResultString ResultID為0時(shí)，內(nèi)容為”O(jiān)K” 　　失敗時(shí)將在本字段表示具體失敗原因。 　　如果是批量訂購且部分成功時(shí)，則該字段為“部分成功” 　　SeqNo SP用于標(biāo)識(shí)唯一一次認(rèn)證請(qǐng)求的號(hào)碼。 　　RandomSessionKey 用戶登錄成功后的臨時(shí)會(huì)話標(biāo)識(shí)。 　　ICPServID SP提供的業(yè)務(wù)代碼，變長(zhǎng)（小于10位）的字符串。 　　TempAuthNo 由SSO平臺(tái)生成的本次訂購操作的臨時(shí)訂購關(guān)系ID，只對(duì)下載業(yè)務(wù)有效，即只有當(dāng)ActionID為10或 　　5時(shí)才返回該字段，ActionID為其他值時(shí)不返回該字段。另外，只有在請(qǐng)求處理成功，即result為0 　　時(shí)才返回該字段。 　　ItemID 用于標(biāo)識(shí)SP的即時(shí)下發(fā)類業(yè)務(wù)（鈴聲、圖片等）唯一性的標(biāo)識(shí)，長(zhǎng)度及格式由SP自行約定，建議只包含數(shù)字和ASC字符。其值將與請(qǐng)求中的ItemID的值相同。 　　本字段只對(duì)下載業(yè)務(wù)有效，即只有當(dāng)ActionID為10時(shí)才返回本字段，ActionID為其他值時(shí)不返回本字段。 　　FeePseudoCode 計(jì)費(fèi)用戶偽碼； 　　當(dāng)響應(yīng)包中沒有FeeMSISDN時(shí)，此字段為必填項(xiàng)；當(dāng)響應(yīng)包中有FeeMSISDN字段時(shí)，則該字段為可選字段。 　　FeeMSISDN 計(jì)費(fèi)用戶的手機(jī)號(hào)碼； 　　要求能維護(hù)一個(gè)icp列表，對(duì)列表中有的icp才填該字段，否則，響應(yīng)包中不包含該字段 　　DestPseudoCode 被贈(zèng)送者的用戶偽碼；當(dāng)用戶輸入了多個(gè)被贈(zèng)送用戶手機(jī)號(hào)碼時(shí)，多個(gè)偽碼之間用逗號(hào)（“,”）分隔。 　　該字段僅當(dāng)請(qǐng)求中的ActionID為5時(shí)有效，ActionID為其他值時(shí)不返回本字段； 　　當(dāng)響應(yīng)包中沒有DestMSISDN時(shí)，此字段為必填項(xiàng)；當(dāng)響應(yīng)包中有DestMSISDN字段時(shí)，則該字段為可選字段。 　　DestMSISDN 被贈(zèng)送用戶的手機(jī)號(hào)碼；當(dāng)用戶輸入了多個(gè)被贈(zèng)送用戶手機(jī)號(hào)碼時(shí)，多個(gè)號(hào)碼之間用逗號(hào)（“,”）分隔。 　　該字段僅當(dāng)請(qǐng)求中的ActionID為10時(shí)有效，ActionID為其他值時(shí)不返回本字段； 　　要求能維護(hù)一個(gè)icp列表，對(duì)列表中有的icp才填該字段，否則，響應(yīng)包中不包含該字段 　　 　　服務(wù)下發(fā)請(qǐng)求接口 　　 　　接口名稱 服務(wù)下發(fā)請(qǐng)求接口 　　接口描述 SP系統(tǒng)向SSO平臺(tái)開放的服務(wù)下發(fā)請(qǐng)求接口用于完成向用戶下發(fā)服務(wù)的功能。 　　該接口主要用于處理SSO平臺(tái)在用戶完成服務(wù)訂購后需要向用戶下發(fā)服務(wù)時(shí)的情況。 　　接口協(xié)議 HTTP協(xié)議，使用GET請(qǐng)求 　　接口方向 請(qǐng)求：SSO平臺(tái)SP 　　響應(yīng)：SPSSO平臺(tái) 　　 　　服務(wù)下發(fā)請(qǐng)求接口的參數(shù)描述： 　　ICPCode SP的企業(yè)代碼，長(zhǎng)度最長(zhǎng)為6位，格式是9XYnnn,XY表示SP接入地的短信網(wǎng)關(guān)編號(hào)，nnn表示序列號(hào)。 　　ICPServID SP提供的短信業(yè)務(wù)的業(yè)務(wù)代碼，變長(zhǎng)（小于等于10位）的字符串。 　　SeqNo SP用于標(biāo)識(shí)唯一一次認(rèn)證請(qǐng)求的號(hào)碼，該號(hào)碼與SP在服務(wù)訂購請(qǐng)求中的傳入的SeqNo相同； 　　ItemID 用于標(biāo)識(shí)SP的即時(shí)下發(fā)類業(yè)務(wù)（鈴聲、圖片等）唯一性的標(biāo)識(shí)。 　　該字段為可選參數(shù)；該字段的值與SP在服務(wù)訂購請(qǐng)求中的傳入的ItemID相同。 　　FeePseudoCode 計(jì)費(fèi)用戶偽碼； 　　當(dāng)響應(yīng)包中沒有FeeMSISDN時(shí)，此字段為必填項(xiàng)；當(dāng)響應(yīng)包中有FeeMSISDN字段時(shí)，則該字段為可 　　選字段。 　　FeeMSISDN 計(jì)費(fèi)用戶的手機(jī)號(hào)碼； 　　要求能維護(hù)一個(gè)icp列表，對(duì)列表中有的icp才填該字段，否則，響應(yīng)包中不包含該字段 　　DestPseudoCode 接收服務(wù)的用戶的偽碼；當(dāng)需要向多個(gè)用戶下發(fā)服務(wù)時(shí)，多個(gè)偽碼之間用逗號(hào)（“,”）分隔。 　　當(dāng)請(qǐng)求中沒有DestMSISDN時(shí)，此字段為必填項(xiàng)；當(dāng)請(qǐng)求中有DestMSISDN字段時(shí)，則該字段為可選字 　　段。 　　DestMSISDN 接收服務(wù)的用戶的手機(jī)號(hào)碼；當(dāng)需要向多個(gè)用戶下發(fā)服務(wù)時(shí)，多個(gè)號(hào)碼之間用逗號(hào)（“,”）分隔。 　　要求能維護(hù)一個(gè)icp列表，對(duì)列表中有的icp才填該字段，否則，響應(yīng)包中不包含該字段 　　LinkID 臨時(shí)訂購關(guān)系的匹配碼，用來鑒權(quán)一次點(diǎn)播請(qǐng)求等事務(wù)性的業(yè)務(wù)。 　　 　　第二章、業(yè)務(wù)改造分冊(cè) 　　MISC系統(tǒng)結(jié)構(gòu)和作用 　　SP接入MISC流程 　　SP升級(jí)前后特性對(duì)比 　　業(yè)務(wù)梳理及業(yè)務(wù)代碼改造 　　點(diǎn)播、訂購指令MO匹配 　　訂購、取消及包月收取 　　業(yè)務(wù)組合模式說明 　　特殊業(yè)務(wù)流程舉例 　　 　　一、業(yè)務(wù)改造 　　業(yè)務(wù)改造重要性說明 　　? 業(yè)務(wù)改造是否合理決定了SP的業(yè)務(wù)能否順利接入MISC，所以請(qǐng)各SP在培訓(xùn)完后盡快派專人進(jìn)行分析和梳理業(yè)務(wù)的工作。業(yè)務(wù)改造分為以下幾個(gè)步驟： 　　1）業(yè)務(wù)類型劃分 　　2）業(yè)務(wù)代碼整理 　　3）點(diǎn)播、定制指令設(shè)置 　　4）資費(fèi)信息設(shè)置 　　5）反向訂購業(yè)務(wù)申請(qǐng) 　　 　　SP升級(jí)前后特性對(duì)比 　　項(xiàng)目說明 升級(jí)前狀態(tài) 升級(jí)后狀態(tài) 　　? 訂購關(guān)系保存 　　所有訂購關(guān)系由SP自行掌握 訂購關(guān)系同時(shí)保存在MISC系統(tǒng)和SP系統(tǒng)中，但是以MISC系統(tǒng)中的訂購關(guān)系為準(zhǔn) 　　? 訂購、取消通知下發(fā) 　　SP自行組包生成訂購、取消通知消息下發(fā)給用戶 MISC平臺(tái)根據(jù)SP申報(bào)的短信提醒下發(fā)給用戶 　　? 0000、00000統(tǒng)一取消指令 　　SP收到0000時(shí)組包產(chǎn)生取消菜單下發(fā)給用戶，收到00000自行取消用戶訂購關(guān)系 MISC平臺(tái)攔截0000指令并自行組包產(chǎn)生菜單下發(fā)，攔截00000指令自動(dòng)取消用戶訂購的所有業(yè)務(wù) 　　? 包月話單發(fā)起扣費(fèi) 　　由SP自行發(fā)起SMC包月扣費(fèi)請(qǐng)求 由MISC根據(jù)有效用戶訂購關(guān)系代SP發(fā)起SMC包月扣費(fèi)請(qǐng)求 　　? 訂購、點(diǎn)播鑒權(quán) 　　不進(jìn)行訂購、點(diǎn)播鑒權(quán)，所有消息全部由網(wǎng)關(guān)透?jìng)鹘oSP 所有的MO/MT消息都需要通過MISC的鑒權(quán)，實(shí)現(xiàn)有效攔截 　　? 訂購關(guān)系同步 　　訂購關(guān)系都保存在SP方，不存在訂購關(guān)系同步 訂購關(guān)系保存在MISC系統(tǒng)，所有的訂購請(qǐng)求都由MISC通過Provision接口與SP同步 　　? 網(wǎng)站訂購、點(diǎn)播處理 　　SP的網(wǎng)站點(diǎn)播和定制都由SP自身來控制，網(wǎng)關(guān)負(fù)責(zé)消息轉(zhuǎn)發(fā) SP的所有網(wǎng)站點(diǎn)播和定制業(yè)務(wù)都需要通過調(diào)用SSO接口來實(shí)現(xiàn) 　　 　　 　　 　　業(yè)務(wù)梳理及改造過程 　　項(xiàng)目說明 升級(jí)前狀態(tài) 升級(jí)后狀態(tài) 　　? 業(yè)