北京聯(lián)通SP管理系統(tǒng)培訓(xùn)文檔(yzh).doc

中國(guó)聯(lián)通北京分公司 聯(lián)通在信業(yè)務(wù) SP 管理系統(tǒng) 培訓(xùn)規(guī)范 SP V1 1 中國(guó)聯(lián)通北京分公司 2004 年 02 月 27 日 目目 錄錄 1 版本與修改說(shuō)明 2 2 總則 3 背景 3 文檔內(nèi)容 3 適用范圍 3 術(shù)語(yǔ)與縮略語(yǔ) 3 參考文獻(xiàn) 4 3 業(yè)務(wù)模型與優(yōu)化 5 3 1 典型業(yè)務(wù)流程 5 4 SP 的接口 7 4 1 SP 與 SMG 之間的接口 7 4 2 SP 與 SPMS 之間的接口 8 5 SP 業(yè)務(wù)規(guī)范 18 1 1 版本與修改說(shuō)明版本與修改說(shuō)明 序號(hào)序號(hào)版本號(hào)版本號(hào)修改人修改人修改日期修改日期修改內(nèi)容修改內(nèi)容 11 0 2 2 總則總則 背景背景 目前聯(lián)通在信網(wǎng)絡(luò)基本運(yùn)行正常 業(yè)務(wù)發(fā)展前景良好 但也存在一些問(wèn)題 包括對(duì) SP 缺乏有效的管理約束手段 業(yè)務(wù)內(nèi)容和聯(lián)通用戶(hù)資料均由 SP 提供 無(wú)法監(jiān)控 SP 下發(fā)消息的合法性 對(duì)用戶(hù)利益造成損失 并影響聯(lián)通的形象 同 時(shí)用戶(hù)的訂制及退訂業(yè)務(wù)流程不統(tǒng)一 存在訂制容易退訂難的問(wèn)題 不利于聯(lián) 通在信業(yè)務(wù)的良性發(fā)展 鑒于以上原因 中國(guó)聯(lián)通北京分公司計(jì)劃建設(shè)聯(lián)通在 信業(yè)務(wù) SP 管理系統(tǒng)工程 并針對(duì)在北京 SMG 接入的本地 SP 進(jìn)行管理 文檔內(nèi)容文檔內(nèi)容 本文主要規(guī)定了中國(guó)聯(lián)通北京分公司聯(lián)通在信業(yè)務(wù) SP 管理系統(tǒng) 以下簡(jiǎn)稱(chēng) SPMS 與其他應(yīng)用系統(tǒng)的接口規(guī)范 適用范圍適用范圍 本文主要用于中國(guó)聯(lián)通北京分公司聯(lián)通在信業(yè)務(wù) SP 管理系統(tǒng)建設(shè)中聯(lián)通在 信業(yè)務(wù)提供商 SP 的配合 用于指導(dǎo)北分和 SP 業(yè)務(wù)建設(shè)的研發(fā)和實(shí)施 本文 適用于 SP CP SPMS 系統(tǒng)建設(shè)廠(chǎng)家和聯(lián)通北京分公司的管理及技術(shù)人員等 術(shù)語(yǔ)與縮略語(yǔ)術(shù)語(yǔ)與縮略語(yǔ) 縮略語(yǔ)縮略語(yǔ)全稱(chēng)全稱(chēng)說(shuō)明說(shuō)明 SPSPService Provider 業(yè)務(wù)提供者 SMGSMGShort Message Gateway 短消息網(wǎng)關(guān) SMSCSMSCShort Message Service Center 短消息中心 SMPPSMPPShort Message Peer to Peer 短消息點(diǎn)對(duì)點(diǎn)協(xié)議 SGIPSGIPShort message Gateway Interface Protocol 短消息網(wǎng)關(guān)接口協(xié)議 MOMOMobile Original 移動(dòng)用戶(hù)發(fā)送短消息 MTMTMobile Terminal 移動(dòng)用戶(hù)接收短消息 參考文獻(xiàn)參考文獻(xiàn) 短消息業(yè)務(wù)聯(lián)網(wǎng)協(xié)議 1 2 版 短消息業(yè)務(wù)聯(lián)網(wǎng)規(guī)范 1 2 版 中國(guó)聯(lián)通北京分公司聯(lián)通在信業(yè)務(wù) SP 管理系統(tǒng)工程技 術(shù) 規(guī) 范 書(shū) 點(diǎn)對(duì)點(diǎn)短消息協(xié)議 SMPP3 4 3 3 業(yè)務(wù)模型與優(yōu)化業(yè)務(wù)模型與優(yōu)化 3 1 3 1 典型業(yè)務(wù)流程典型業(yè)務(wù)流程 3 1 1 3 1 1 手機(jī)手機(jī) MOMO 點(diǎn)播流程點(diǎn)播流程 通信流程如下 1 手機(jī)用戶(hù)發(fā)起短消息點(diǎn)播請(qǐng)求 2 本地 SMG 將該請(qǐng)求送往 SPMS 系統(tǒng) 由 SPMS 進(jìn)行相應(yīng)處理 如果判 斷該用戶(hù)是在正常點(diǎn)播某項(xiàng)業(yè)務(wù) 則記錄相關(guān) MO 請(qǐng)求記錄并生成 唯一標(biāo)識(shí) linkid 以便 SP 下發(fā) MT 消息時(shí)實(shí)現(xiàn)鑒權(quán) 3 SMG 將點(diǎn)播請(qǐng)求上行給 SP 在 DELIVER 包中攜帶此唯一標(biāo)識(shí) linkid 4 SP 處理點(diǎn)播請(qǐng)求 在相應(yīng)的 SUBMIT 包中攜帶此唯一標(biāo)識(shí) linkid 5 SMG 將 SUBMIT 包送給 SPMS 作下行鑒權(quán) SPMS 判斷此 SUBMIT 包是 否是合法 并由 SMG 將該 SUBMIT 下發(fā)給用戶(hù) 3 1 2 3 1 2 手機(jī)手機(jī) MOMO 定制流程定制流程 1 手機(jī)用戶(hù)發(fā)起業(yè)務(wù)訂制請(qǐng)求 MO MO 內(nèi)容為定制業(yè)務(wù)相關(guān)命令代碼 2 SMG 將定制請(qǐng)求轉(zhuǎn)給 SPMS SPMS 生成臨時(shí)訂制關(guān)系 向用戶(hù)下發(fā)訂制 確認(rèn)短信 3 用戶(hù)回復(fù)確認(rèn) Y 表訂制 N 表取消 短信 4 SPMS 轉(zhuǎn)發(fā) Deliver 包給 SP 帶 LinkID 5 SP 下發(fā)訂制成功 失敗通知包給用戶(hù) 帶 LinkID 6 SPMS 根據(jù)通知包生成正式訂制關(guān)系 7 SP 根據(jù)訂制規(guī)則向用戶(hù)下發(fā)業(yè)務(wù)消息 不帶 LinkID 8 SPMS 根據(jù)用戶(hù)訂制關(guān)系進(jìn)行鑒權(quán) 3 1 3 3 1 3 手機(jī)取消定制流程手機(jī)取消定制流程 1 用戶(hù)發(fā)起業(yè)務(wù)退訂請(qǐng)求 MO MO 內(nèi)容為退定定制業(yè)務(wù)的相關(guān)命令代碼 2 SPMS 向用戶(hù)下發(fā)退訂確認(rèn)短信 3 用戶(hù)回復(fù)確認(rèn)短信 4 SPMS 取消用戶(hù)和該業(yè)務(wù)的訂購(gòu)關(guān)系 退訂用戶(hù)業(yè)務(wù) 轉(zhuǎn)發(fā) Deliver 包給 SP 帶 LinkID 5 SP 下發(fā)退訂成功 失敗通知包用戶(hù) 6 SPMS 根據(jù) LinkID 及退訂關(guān)系進(jìn)行鑒權(quán) 3 1 4 3 1 4 網(wǎng)上注冊(cè)流程網(wǎng)上注冊(cè)流程 網(wǎng)上注冊(cè)流程與網(wǎng)上點(diǎn)播流程相同 作為一項(xiàng)特殊的點(diǎn)播業(yè)務(wù) 3 1 5 3 1 5 網(wǎng)上點(diǎn)播流程網(wǎng)上點(diǎn)播流程 1 用戶(hù)在網(wǎng)上點(diǎn)播業(yè)務(wù) 2 SP 通過(guò) HTTP 方式調(diào)用 SPMS 點(diǎn)播接口 掛起用戶(hù)請(qǐng)求 等待用戶(hù)輸入 確認(rèn)碼 3 SPMS 生成確認(rèn)碼并向用戶(hù)下發(fā)確認(rèn)碼短信 4 用戶(hù)收到確認(rèn)碼短信 在 WEB 頁(yè)面上輸入確認(rèn)碼 5 SP 下發(fā)點(diǎn)播消息 將用戶(hù)輸入的確認(rèn)碼作為 LinkID 填在 Sumit 包中 6 SPMS 根據(jù)確認(rèn)碼及點(diǎn)播關(guān)系進(jìn)行鑒權(quán) 3 1 6 3 1 6 網(wǎng)上定制流程網(wǎng)上定制流程 1 SP 通過(guò) HTTP 方式調(diào)用 SPMS 提供的定購(gòu)接口 2 SPMS 生成臨時(shí)訂制關(guān)系 向用戶(hù)下發(fā)訂制確認(rèn)短信 3 用戶(hù)回復(fù)確認(rèn) Y 表訂制 N 表取消 短信 4 SPMS 發(fā) Deliver 包給 SP 帶 LinkID 5 SP 下發(fā)訂制成功 失敗通知包用戶(hù) 6 SPMS 根據(jù)通知包生成正式訂制關(guān)系 7 SP 根據(jù)訂制規(guī)則向用戶(hù)下發(fā)業(yè)務(wù)消息 不帶 LinkID 8 SPMS 根據(jù)用戶(hù)訂制關(guān)系進(jìn)行鑒權(quán) 3 1 7 3 1 7 網(wǎng)上取消定制流程網(wǎng)上取消定制流程 1 用戶(hù)在 SP WEB 上發(fā)起業(yè)務(wù)退訂請(qǐng)求 2 SP 通過(guò) HTTP 方式調(diào)用 SPMS 提供的業(yè)務(wù)退訂接口 3 SPMS 向用戶(hù)下發(fā)退訂確認(rèn)短信 4 用戶(hù)回復(fù)確認(rèn)短信 5 SPMS 退訂用戶(hù)業(yè)務(wù) 轉(zhuǎn)發(fā) Deliver 包給 SP 帶 LinkID 6 SP 下發(fā)退訂成功 失敗通知包用戶(hù) 帶 LinkID 7 SPMS 根據(jù) LinkID 及退訂關(guān)系進(jìn)行鑒權(quán) 4 4 SPSP 的接口的接口 4 1 4 1 SPSP 與與 SMGSMG 之間的接口之間的接口 SP 需規(guī)范 SGIP 協(xié)議的填寫(xiě) 具體需要注意的字段如下 4 1 1 4 1 1 DeliverDeliver 包中的包中的 ReserveReserve 字段字段 該 Reserve 字段為 8 個(gè)字節(jié)的保留字段 現(xiàn)將該字段作為 MO 和 MT 之間一 一對(duì)應(yīng)的 LinkID 來(lái)用 該 Reserve 的值 LinkID 由 SPMS 業(yè)務(wù)鑒權(quán)平臺(tái)生成 傳給 SPSMG 由 SPSMG 不做任何改動(dòng)傳給 SP 用來(lái)標(biāo)識(shí)點(diǎn)播的 MO 消息 使得 MT 如果 MO 引起多條 MT 則每條 MT 都要 將 MO 中的 Reserve 中的值取出 賦值到 Submit 包中的 Reserve 消息能夠匹 配對(duì)應(yīng)的 MO 消息 非 MO 所引起的 MT SP 不填寫(xiě)該 LinkID 4 1 2 4 1 2 SubmitSubmit 中的中的 ReserveReserve 字段字段 該 Reserve 字段為 8 個(gè)字節(jié)的保留字段 現(xiàn)將該字段作為 MO 和 MT 之間一 一對(duì)應(yīng)的 LinkID 來(lái)用 該 Reserve 字段的值 LinkID 由 SPMS 業(yè)務(wù)鑒權(quán)平臺(tái)生成 傳給 SPSMG SPSMG 將對(duì) MO 所引起的下發(fā) MT 進(jìn)行 Reserve LinkID 值的匹配校驗(yàn) 4 1 3 4 1 3 SubmitSubmit 包的包的 UserCountUserCount 字段填寫(xiě)限制字段填寫(xiě)限制 該字段 SP 下發(fā)時(shí)必須填寫(xiě) 1 否則視為業(yè)務(wù)非法包處理 4 1 4 4 1 4 SubmitSubmit 包的包的 MORelatetoMTFlagMORelatetoMTFlag 字段字段 在由該 MO 引起的 MT 中 第一條 MT 下行該字段為 0 以后的各條該字段為 1 定制信息請(qǐng)?jiān)O(shè)置為 2 包月費(fèi)下發(fā)信息設(shè)置為 3 4 2 4 2 SPSP 與與 SPMSSPMS 之間的接口之間的接口 4 2 1 4 2 1 SPSP 基本資料同步接口基本資料同步接口 發(fā)起方 SP 一個(gè) SP 一條記錄 接收方 SPMS 接口協(xié)議 FTP EMAIL 接口形式 文本文件 同步時(shí)間 已經(jīng)接入到聯(lián)通在信的 SP 可通過(guò)此文本文件將 SP 的基本信息 同步給 SP 管理系統(tǒng) SP 也可不使用該接口 而直接登錄 SP 管理系統(tǒng)的 SP 自服務(wù)門(mén)戶(hù) 以手工錄入的方法將 SP 基本信息提交給 SP 管理系統(tǒng) 文件命名 SP 5 位 SP 企業(yè)代碼 8 位時(shí)間 4 位序號(hào) TXT 如 SP30165200401010001 TXT 文件內(nèi)容 文件以 TXT 格式存儲(chǔ) 以下每個(gè)字段占據(jù)一行 序號(hào)序號(hào)字段名字段名最大長(zhǎng)度最大長(zhǎng)度 字節(jié) 字節(jié) 說(shuō)明說(shuō)明 1 SP 企業(yè)代碼 5 不能為空 2 SP 的接入號(hào)碼 10 3 SP 的地址 3 不能為空 4 SP 的守護(hù)端口不能為空 5 SP 的接入位置不能為空 6 SP 到 SPSMG 的用戶(hù) 名 不能為空 7 SP 到 SPSMG 的口令不能為空 8 SPSMG 到 SP 的用戶(hù) 名 不能為空 9 SPSMG 到 SP 的口令不能為空 10 SP 的開(kāi)戶(hù)銀行不能為空 11 SP 的銀行帳戶(hù)不能為空 12正式商用日期 不能為空 13 主頁(yè)地址 14 ICP 證號(hào) 15頒證單位 16 負(fù)責(zé)人姓名 17 負(fù)責(zé)人性別 18 負(fù)責(zé)人職務(wù) 19 負(fù)責(zé)人 Email 20 負(fù)責(zé)人辦公電話(huà) 21 負(fù)責(zé)人移動(dòng)電話(huà) 22 聯(lián)系人姓名 23 聯(lián)系人性別 24 聯(lián)系人職務(wù) 25 聯(lián)系人 Email 26 聯(lián)系人辦公電話(huà) 27 聯(lián)系人移動(dòng)電話(huà) 28 公司名稱(chēng) 29公司簡(jiǎn)稱(chēng) 30英文名稱(chēng) 31成立時(shí)間 32法人代表 33公司經(jīng)理 34公司類(lèi)型 35是否上市 36注冊(cè)資金 37員工人數(shù) 38所在地 39主要業(yè)務(wù) 4 2 2 4 2 2 SPSP 業(yè)務(wù)資料同步接口業(yè)務(wù)資料同步接口 發(fā)起方 SP 接收方 SPMS 接口協(xié)議 FTP EMAIL 接口形式 文本文件 同步時(shí)間 已經(jīng)接入到聯(lián)通在信的 SP 需通過(guò)文件形式將 SP 已開(kāi)通的業(yè)務(wù) 信息同步給 SP 管理系統(tǒng) SP 管理系統(tǒng)根據(jù)已接入的業(yè)務(wù)資料對(duì) MO MT 消息 進(jìn)行鑒權(quán) 文件命名 SPST 5 位 SP 企業(yè)代碼 8 位時(shí)間 4 位序號(hào) TXT 如 SPST30165200401010001 TXT 文件內(nèi)容 文件采用 ASCII 文本格式 文件體中一行作為一條記錄 每一 條記錄代表 sp 的一個(gè)業(yè)務(wù) 記錄的屬性值按順序排列 各屬性間使用 t 分隔 各條記錄之間用換行符作為分隔 序序 號(hào)號(hào) 字段名字段名最大長(zhǎng)度最大長(zhǎng)度 字節(jié) 字節(jié) 說(shuō)明說(shuō)明 1SP 企業(yè)代碼5 不能為空 2接入子號(hào)碼7 不能填空 3 業(yè)務(wù)代碼 12 不能填空 4 業(yè)務(wù)名稱(chēng) 8 不能填空 5 業(yè)務(wù)申請(qǐng)時(shí)間 16 不能填空 定義如下 6業(yè)務(wù)類(lèi)別 點(diǎn) 播類(lèi) 定制類(lèi) 2 不能為空 0 定制 1 點(diǎn)播 7 業(yè)務(wù)收費(fèi)模式 2 不能為空 0 按條 1 包月 8費(fèi)率4 不能為空 9業(yè)務(wù)收費(fèi)開(kāi)始 時(shí)間 16 不能為空 10業(yè)務(wù)點(diǎn)播代碼 點(diǎn)播類(lèi) 10 不能為空 11業(yè)務(wù)定購(gòu)命令 定制類(lèi) 10 不能為空 12業(yè)務(wù)取消定購(gòu) 命令 定制類(lèi) 10 不能為空 13業(yè)務(wù)下發(fā)周期 定制類(lèi) 2 不能為空 每日 14業(yè)務(wù)開(kāi)展時(shí)間 段 定制類(lèi) 6 不能為空 格式 nn nn 4 2 3 4 2 3 用戶(hù)業(yè)務(wù)定購(gòu)資料同步接口用戶(hù)業(yè)務(wù)定購(gòu)資料同步接口 發(fā)起方 SP 接收方 SPMS 接口協(xié)議 FTP EMAIL 接口形式 文本文件 同步時(shí)間 已經(jīng)接入到聯(lián)通在信的 SP 需通過(guò)文件形式將已定購(gòu) SP 業(yè)務(wù)的 用戶(hù)信息同步給 SP 管理系統(tǒng) 文件命名 SPUS 5 位 SP 企業(yè)代碼 8 位時(shí)間 4 位序號(hào) TXT 如 SPUS30165200401010001 TXT 文件采用 ASCII 文本格式 文件體中一行作為一條記錄 每一條記錄代表 手機(jī)用戶(hù)訂購(gòu)的一個(gè)業(yè)務(wù) 每條記錄的屬性值按順序排列 各屬性間使用 t 分隔 一個(gè)手機(jī)訂購(gòu)多項(xiàng)業(yè)務(wù)需要多條記錄 各條記錄之間用換行 符作為分隔 每個(gè)文件最大記錄數(shù)為每個(gè)文件最大記錄數(shù)為 1010 萬(wàn)條萬(wàn)條 超過(guò)的需要按照文件序列號(hào)遞增的方 式生成新的文件 要求 UserNumber 必須和 ChargeNumber 一致 對(duì)于不 一致的用戶(hù)業(yè)務(wù)訂購(gòu)關(guān)系 SPMS 系統(tǒng)將強(qiáng)制一致性 以 ChargeNumber 為準(zhǔn) 序號(hào)序號(hào)字段名字段名最大長(zhǎng)度最大長(zhǎng)度 字節(jié)字節(jié) 說(shuō)明說(shuō)明 1 企業(yè)代碼 5 不能填空 2 計(jì)費(fèi)手機(jī)號(hào)碼 21 不能填空 3 業(yè)務(wù)代碼 16 4 目的手機(jī)號(hào)碼 21 不能填空 5 定購(gòu)方式 12 統(tǒng)一填 2 SP 同步 6 定制時(shí)間 20 不能填空 格式 YYYYMMDDHH24MISS 7 定購(gòu)數(shù)量 12 不能填空 4 2 4 4 2 4 SPSP 業(yè)務(wù)定購(gòu)業(yè)務(wù)定購(gòu) WEBWEB 調(diào)用接口調(diào)用接口 發(fā)起方 SP 接收方 SPMS 通訊協(xié)議 HTTP 認(rèn)證機(jī)制 數(shù)字證書(shū) IP 認(rèn)證 SPMS 可限制連接的 IP 地址 用戶(hù)身份驗(yàn)證 SP 必須先對(duì)用戶(hù)以手機(jī)號(hào)注冊(cè) 注冊(cè)成功并登陸 SP 社區(qū)后 用戶(hù)才能發(fā)起業(yè)務(wù)定購(gòu)請(qǐng)求 即 SP 必須保證定購(gòu)用戶(hù)的真實(shí)性 接口說(shuō)明 用戶(hù)在 SP 網(wǎng)站上登錄 選擇訂購(gòu)的產(chǎn)品 在 SP 網(wǎng)站完成預(yù)訂 購(gòu)過(guò)程 預(yù)訂購(gòu)時(shí) SP 調(diào)用此接口 接口方式為標(biāo)準(zhǔn)的 HTTP 參數(shù)傳遞采用 GET 方式 傳遞的參數(shù)包含校驗(yàn)碼 SP 代碼 SP 接入號(hào) 付費(fèi)手機(jī)號(hào)碼 目的手機(jī)號(hào) 業(yè)務(wù)代碼 定購(gòu)時(shí)間 定購(gòu)數(shù)量 返回地址 其中 SP 代碼 SP 接入號(hào) 返回地址采用明文傳遞 其他參數(shù)采用 SP 的私鑰加密 SP 私 鑰由 SPMS 通過(guò)郵件或 SP 門(mén)戶(hù)的方式分發(fā) SP 管理系統(tǒng)返回給 SP 預(yù)訂購(gòu)請(qǐng) 求是否成功 HTTP 調(diào)用參數(shù) 序序 號(hào)號(hào) 參數(shù)參數(shù)最大長(zhǎng)度最大長(zhǎng)度 字節(jié) 字節(jié) 含義含義說(shuō)明說(shuō)明 1CorpId10 SP 代碼不能為空 如 30165 2SpNumber21 SP 的接入號(hào)碼不能為空 3EncodeStr255 以 3DES 加密算法加 密字串 校驗(yàn)碼 SP 代碼 付費(fèi)手機(jī)號(hào) 目 的手機(jī)號(hào)碼 業(yè)務(wù)代 碼 定購(gòu)時(shí)間 定購(gòu)數(shù) 量 不能為空 加密前的樣例 1234 3016513000000000XW 2004 02 01 10 00 00 12 4BackUrl255 SPMS 處理完后的返回 地址 SP 可以根據(jù) SPMS 的返回值顯示給 用戶(hù)定購(gòu)結(jié)果 校驗(yàn)碼 SPMS 將校驗(yàn)碼原值返回 用戶(hù) SP 確認(rèn) SPMS 返回的有效性 EncodeStrEncodeStr 生成算法如下 生成算法如下 EncodeStr URLEncoding Base64 Encrypt CorpId SpNumber ChargeNumber UserNumber SvcTypeCode Count URLEncoding 是指對(duì) BASE64 編碼中的 HTML 控制碼進(jìn)行轉(zhuǎn)義的過(guò)程 其具體實(shí)現(xiàn) 參見(jiàn) RFC1738 Encrypt 加密算法采用 3 DES 算法 密鑰為 64 位 密鑰由 SPMS 通過(guò) 郵件或者 SP 門(mén)戶(hù)網(wǎng)站提供的數(shù)字證書(shū)私鑰 注 密鑰是由 SPMS 為每個(gè) SP 單獨(dú)分發(fā) 的數(shù)字證書(shū)私鑰 SP 加密后 SPMS 用對(duì)應(yīng)的公鑰解密 SP 對(duì)數(shù)據(jù)具有不可抵賴(lài)性 調(diào)用示例 umber 3333 AccessCode 2004 EncodeStr KIQWNWEQREQWK921343KJASDFASD BackUrl HTTP 調(diào)用返回參數(shù) A SPMS 根據(jù) SP 提供的 BackUrl 返回 校驗(yàn)碼 AccessCode 付費(fèi)手機(jī)號(hào) ChargeNumber 處理結(jié)果 Result SPMS 處理成功 返回 OK SPMS 處理失敗 返回 Error 錯(cuò)誤碼 返回示例 ChargeNumber 13000000 Result OK 4 2 5 4 2 5 SPSP 業(yè)務(wù)退定業(yè)務(wù)退定 WEBWEB 調(diào)用接口調(diào)用接口 發(fā)起方 SP 接收方 SPMS 通訊協(xié)議 HTTP 認(rèn)證機(jī)制 數(shù)字證書(shū) IP 認(rèn)證 SPMS 可限制連接的 IP 地址 用戶(hù)身份驗(yàn)證 SP 必須先對(duì)用戶(hù)以手機(jī)號(hào)注冊(cè) 注冊(cè)成功并登陸 SP 社區(qū)后 用戶(hù)才能發(fā)起業(yè)務(wù)退定請(qǐng)求 即 SP 必須保證定購(gòu)用戶(hù)的真實(shí)性 同時(shí) SPMS 提供對(duì)用戶(hù)的校驗(yàn) 接口說(shuō)明 用戶(hù)在 SP 網(wǎng)站上登錄 選擇退定的產(chǎn)品 在 SP 網(wǎng)站完成預(yù)退 定過(guò)程 預(yù)退定時(shí) SP 調(diào)用此接口 接口方式為標(biāo)準(zhǔn)的 HTTP 參數(shù)傳遞采用 GET 方式 傳遞的參數(shù)包含 SP 代碼 SP 接入號(hào) 付費(fèi)手機(jī)號(hào)碼 目的手機(jī) 號(hào)碼 業(yè)務(wù)代碼 退定時(shí)間 其中 SP 代碼采用明文傳遞 其他參數(shù)采用 SP 的私鑰加密 SP 私鑰由 SPMS 通過(guò)郵件或 SP 門(mén)戶(hù)的方式分發(fā) SP 管理系統(tǒng) 返回給 SP 預(yù)訂購(gòu)請(qǐng)求是否成功 HTTP 調(diào)用參數(shù) 序序 號(hào)號(hào) 參數(shù)參數(shù)最大長(zhǎng)度最大長(zhǎng)度 字節(jié) 字節(jié) 含義含義說(shuō)明說(shuō)明 1CorpId10 SP 代碼不能為空 如 30165 2SpNumber21 SP 的接入號(hào)碼不能為空 3EncodeStr255 以 3DES 加密算法加 密字串 校驗(yàn)碼 SP 代碼 付費(fèi)手機(jī)號(hào) 目 的手機(jī)號(hào)碼 業(yè)務(wù)代 碼 退定時(shí)間 不能為空 加密前的樣例 1234 3016513000000000XW 2004 02 01 10 00 00 4BackUrl255 SPMS 處理完后的返回 地址 SP 可以根據(jù) SPMS 的返回值顯示給 用戶(hù)定購(gòu)結(jié)果 校驗(yàn)碼 SPMS 將校驗(yàn)碼原值返回 用戶(hù) SP 確認(rèn) SPMS 返回的有效性 EncodeStrEncodeStr 生成算法如下 生成算法如下 EncodeStr URLEncoding Base64 Encrypt CorpId SpNumber ChargeNumber UserNumber SvcTypeCode Count URLEncoding 是指對(duì) BASE64 編碼中的 HTML 控制碼進(jìn)行轉(zhuǎn)義的過(guò)程 其具體實(shí)現(xiàn) 參見(jiàn) RFC1738 Encrypt 加密算法采用 3 DES 算法 密鑰為 64 位 密鑰由 SPMS 通過(guò) 郵件或者 SP 門(mén)戶(hù)網(wǎng)站提供的數(shù)字證書(shū)私鑰 注 密鑰是由 SPMS 為每個(gè) SP 單獨(dú)分發(fā) 的數(shù)字證書(shū)私鑰 SP 加密后 SPMS 用對(duì)應(yīng)的公鑰解密 SP 對(duì)數(shù)據(jù)具有不可抵賴(lài)性 調(diào)用示例 umber 3333 AccessCode 2004 EncodeStr KIQWNWEQREQWK921343KJASDFASD BackUrl HTTP 調(diào)用返回參數(shù) A SPMS 根據(jù) SP 提供的 BackUrl 返回 校驗(yàn)碼 AccessCode 付費(fèi)手機(jī)號(hào) ChargeNumber 處理結(jié)果 Result SPMS 處理成功 返回 OK SPMS 處理失敗 返回 Error 錯(cuò)誤碼 返回示例 ChargeNumber 13000000 Result OK 4 2 6 4 2 6 SPSP 業(yè)務(wù)點(diǎn)播用戶(hù)確認(rèn)接口業(yè)務(wù)點(diǎn)播用戶(hù)確認(rèn)接口 發(fā)起方 SP 接收方 SPMS 通訊協(xié)議 HTTP 認(rèn)證機(jī)制 數(shù)字證書(shū) IP 認(rèn)證 SPMS 可限制連接的 IP 地址 用戶(hù)身份驗(yàn)證 SP 必須先對(duì)用戶(hù)以手機(jī)號(hào)注冊(cè) 注冊(cè)成功并登陸 SP 社區(qū)后 用戶(hù)才能發(fā)起業(yè)務(wù)點(diǎn)播請(qǐng)求 即 SP 必須保證點(diǎn)播用戶(hù)的真實(shí)性 接口說(shuō)明 用戶(hù)在 SP 站點(diǎn)上點(diǎn)播業(yè)務(wù)時(shí) 需要確認(rèn)該點(diǎn)播是由用戶(hù)主動(dòng)發(fā) 起 所以要求用戶(hù)點(diǎn)播時(shí)輸入由 SPMS 提供的點(diǎn)播確認(rèn)碼 以圖片的方式提 示給用戶(hù) 點(diǎn)播確認(rèn)碼由 SPMS 以短信方式下發(fā)給在網(wǎng)上進(jìn)行點(diǎn)播操作的 用戶(hù)手機(jī) 由用戶(hù)通過(guò)確認(rèn)頁(yè)面重新輸入系統(tǒng) SPMS 根據(jù)確認(rèn)圖片隨機(jī)碼 確認(rèn)該次請(qǐng)求是否合法 HTTP 點(diǎn)播調(diào)用參數(shù) 序序 號(hào)號(hào) 參數(shù)參數(shù)最大長(zhǎng)度最大長(zhǎng)度 字節(jié) 字節(jié) 含義含義說(shuō)明說(shuō)明 1CorpId10 SP 代碼不能為空 如 30165 2SpNumber21 SP 的接入號(hào)碼不能為空 3EncodeStr255 以 3DES 按 ECB 模式 加密算法加密字符串 校驗(yàn)碼 SP 接入號(hào) 碼 付費(fèi)手機(jī)號(hào) 目的 手機(jī)號(hào) 點(diǎn)播標(biāo)識(shí) 操 作命令字 點(diǎn)播時(shí)間 然后用 BASE64 算法 和 URLEncoding 算法 進(jìn)行編碼 不能為空 用戶(hù)手機(jī)為網(wǎng)上 操作點(diǎn)播的用戶(hù) 對(duì)于無(wú)命 令字的業(yè)務(wù)填寫(xiě) 4BackUrl255 SPMS 處理完后的返回 地址 SP 可以根據(jù) SPMS 的返回值顯示給 用戶(hù)定購(gòu)結(jié)果 校驗(yàn)碼 SPMS 將校驗(yàn)碼原值返回 用戶(hù) SP 確認(rèn) SPMS 返回的有效性 EncodeStrEncodeStr 生成算法如下 生成算法如下 EncodeStr URLEncoding Base64 Encrypt SpNumber UserNumber ServiceTag AccessTime URLEncoding 是指對(duì) BASE64 編碼中的 HTML 控制碼進(jìn)行轉(zhuǎn)義的過(guò)程 其具體實(shí)現(xiàn) 參見(jiàn) RFC1738 Encrypt 加密算法采用 3 DES 算法 密鑰為 64 位 調(diào)用示例 umber 3333 AccessCode 2004 EncodeStr KIQWNWEQREQWK921343KJASDFASD BackUrl HTTP 點(diǎn)播調(diào)用返回參數(shù) A SPMS 根據(jù) SP 提供的 BackUrl 返回 校驗(yàn)碼 AccessCode 付費(fèi)手機(jī)號(hào) ChargeNumber 點(diǎn)播標(biāo)識(shí) MessgeID 由 LinkID 處理失敗不返回 處理結(jié)果 Result SPMS 處理成功 返回 OK SPMS 處理失敗 返回 Error 錯(cuò)誤碼 返回示例 ChargeNumber 13000000 MessageID 18016 LinKID 2031 Result OK 處理流程 A 用戶(hù)在 SP 站點(diǎn)點(diǎn)播業(yè)務(wù)時(shí) SP 網(wǎng)站用標(biāo)準(zhǔn)的標(biāo)準(zhǔn)的 HTTP 方式向 SPMS 系統(tǒng)的點(diǎn)播確認(rèn)接口提交一個(gè)請(qǐng)求 B SPMS 將給網(wǎng)上點(diǎn)播操作的用戶(hù)的手機(jī)發(fā)送點(diǎn)播確認(rèn)碼 C SP 網(wǎng)站將提供一個(gè)點(diǎn)播確認(rèn)碼輸入框在點(diǎn)播確認(rèn)的頁(yè)面上 用戶(hù)填寫(xiě) 點(diǎn)播確認(rèn)碼 用戶(hù)提交點(diǎn)播請(qǐng)求后 SPMS 根據(jù) SP 提供的返回地址 將 操作結(jié)果返回 SP 操作成功的返回中包含 LinkID 點(diǎn)播確認(rèn)碼 隨機(jī) 碼 和 SP 提供的點(diǎn)播標(biāo)識(shí) SP 根據(jù)返回下發(fā)消息 并將 LinkID 加到 下發(fā)的 SGIP 包中 填寫(xiě)在 Reserved 字段中 提交 MT 到 SPSMG D SPSMG 接收到此 MT 請(qǐng)求 交給 SP 管理系統(tǒng)中的業(yè)務(wù)鑒權(quán)中心 業(yè)務(wù)鑒 權(quán)中心讀取數(shù)據(jù)庫(kù) 發(fā)現(xiàn)此 LinkID 點(diǎn)播確認(rèn)碼 隨機(jī)碼 有效 允 許發(fā)送 5 5 SPSP 業(yè)務(wù)規(guī)范業(yè)務(wù)規(guī)范 命令字最大長(zhǎng)度為 12 位字符 命令字只能由 0 9 A Z a z 此 64 個(gè)字符構(gòu)成 不能使用其它特殊字符 SPMS 解析命令字時(shí) 遇到除此 64 個(gè)字符外的其它字符 即認(rèn)為命令字已結(jié)束 如 TQDZ 010 TQDZ 020 TQDZ 020 會(huì)被解析為同一個(gè)業(yè)務(wù)請(qǐng)求 在 MO 業(yè)務(wù)請(qǐng)求消息中 建議命令 字與其它內(nèi)容以空格或 號(hào)分隔 對(duì)于 SP 的定制類(lèi)業(yè)務(wù)