中國(guó)電信寬樂通信接口規(guī)范文檔.doc

深圳電信寬樂通信業(yè)務(wù)接口規(guī)范深圳電信寬樂通信業(yè)務(wù)接口規(guī)范 修訂版修訂版 2 0 深圳電信分公司深圳電信分公司 增值業(yè)務(wù)部增值業(yè)務(wù)部 1 1 概述 概述 3 3 1 1接口原則 3 1 2目標(biāo) 3 1 3接口的調(diào)用方式 3 1 4帳號(hào)申請(qǐng) 4 2 2 卓越通信向第三方提供的接口信息描述 卓越通信向第三方提供的接口信息描述 4 4 2 1總述 4 2 2接口定義說明 7 2 2 1注冊(cè)接口 7 2 2 2CTD 相關(guān)接口 9 2 2 3CTC 相關(guān)接口 12 2 2 4SendSMS 短信相關(guān)接口 18 2 2 5第三方服務(wù)器需要實(shí)現(xiàn)通用回調(diào)函數(shù) 20 3 3 加密規(guī)則 加密規(guī)則 2424 4 4 通用失敗碼通用失敗碼 2424 1 概述概述 本文檔主要描述了深圳電信寬樂通信接口平臺(tái)對(duì)第三方合作商開放業(yè)務(wù)能力的 WebService 接口和使用規(guī)范 經(jīng)運(yùn)營(yíng)商分配給使用賬號(hào)后 第三方合作商能夠使用寬樂通信業(yè)務(wù)平臺(tái)的通信服務(wù)資 源 主要有點(diǎn)擊撥號(hào) 短信收發(fā) 多方會(huì)議 網(wǎng)絡(luò)傳真功能等服務(wù) 1 1 接口原則接口原則 第三方軟件商在進(jìn)行開發(fā) 使用相關(guān)接口時(shí) 須遵循以下原則 嚴(yán)格按照接口規(guī)范文檔中所定義的規(guī)范格式 進(jìn)行數(shù)據(jù)處理 對(duì)于新增通信服務(wù) 將由深圳電信制定標(biāo)準(zhǔn)接口 并更新接口協(xié)議 通知第三方 各軟件合作商 1 2 目標(biāo)目標(biāo) 寬樂通信與第三方軟件商接口功能達(dá)到如下目標(biāo) 接口簡(jiǎn)單便于操作 并能夠兼容接口以后擴(kuò)充 提供對(duì)外的開放性 能夠具備接入認(rèn)證功能 保證系統(tǒng)的安全性 接口標(biāo)準(zhǔn)對(duì)外可靠和高效 提供解決故障的手段和流程機(jī)制 由于面向客戶提供的服務(wù)將由傳統(tǒng)方式中的運(yùn) 營(yíng)商一種角色 轉(zhuǎn)變成軟件合作商和運(yùn)營(yíng)商多個(gè)角色 因此須提供高效的機(jī)制 能夠定位故障和解決 1 3 接口的調(diào)用方式接口的調(diào)用方式 實(shí)現(xiàn)方式 調(diào)用 Web Service 服務(wù) 遵循標(biāo)準(zhǔn)的 soap 協(xié)議 第三方軟件產(chǎn)品與寬樂通信業(yè)務(wù)平臺(tái)互為客戶端和服務(wù)端 第三方軟件產(chǎn)品按照各操作規(guī)范和文檔格式進(jìn)行數(shù)據(jù)填充 主動(dòng)調(diào)用寬樂通信業(yè) 務(wù)平臺(tái)提供的相關(guān) Web Service 服務(wù) 平臺(tái)根據(jù)應(yīng)用請(qǐng)求注冊(cè)的回調(diào)處理地址 異步 返回回調(diào)處理 異步調(diào)用 同步響應(yīng) 請(qǐng)求 卓越通信通信 資源 第三方應(yīng)用系統(tǒng)或 軟件產(chǎn)品 1 4 帳號(hào)申請(qǐng)帳號(hào)申請(qǐng) 凡需使用深圳電信寬樂通信相關(guān)通信資源的的第三方合作商 需至深圳電信申請(qǐng)相應(yīng) 的寬樂通信帳號(hào) 該寬樂通信帳號(hào)具備相應(yīng)的業(yè)務(wù)使用能力 2 寬樂通信向第三方提供的接口信息描述寬樂通信向第三方提供的接口信息描述 2 1 總述總述 第三方合作商應(yīng)用服務(wù)器與寬樂通信業(yè)務(wù)平臺(tái)互相開放 WebService 接口 互為服務(wù)端 和客戶端 接口符合本文定義 無(wú)論第三方應(yīng)用服務(wù)器通過公網(wǎng)或者專線接入寬樂通信業(yè) 務(wù)平臺(tái) 都需要寬樂通信業(yè)務(wù)平臺(tái)提供注冊(cè)回調(diào)地址 以便寬樂通信業(yè)務(wù)平臺(tái)能夠異步推 送結(jié)果響應(yīng)和相關(guān)服務(wù)結(jié)果 同時(shí)需保證第三方應(yīng)用服務(wù)器能夠正常訪問寬樂通信業(yè)務(wù)平 臺(tái)的 WebService 服務(wù) 寬樂通信業(yè)務(wù)平臺(tái)提供5個(gè)WebService 接口 a 注冊(cè)接口 Register URL http 202 105 212 146 8080 jboss net services Register b CTD 接口 CTDCall URL http IP port axis services CTDCall c CTC 接口 CTCCall URL http IP port axis services CTCCall d 收發(fā)短信 SendSMS URL http 202 105 212 146 8080 jboss net services SendSMS 方法包括 sendSMS e FAX 接口 FAXServ 請(qǐng)參見 網(wǎng)絡(luò)傳真接口規(guī)范文檔 客戶端在進(jìn)行訪問以上接口服務(wù)時(shí)均需進(jìn)行鑒權(quán) 需添加用戶名 密碼 鑒權(quán)信 息如下 用戶名 test 密碼 test 第三方必須提供WebService 回調(diào)地址 主要含如下內(nèi)容 接口 方法 notifyStatus URL 由第三方軟件合作商給出 下表列出寬樂通信接口平臺(tái)定義的全部WebService請(qǐng)求和事件報(bào)告所使用的接口 方法 接口 請(qǐng)求和事件方法 函數(shù) 方向 3rd Server 為第三方應(yīng)用平臺(tái) KLTX 為寬樂通信業(yè) 務(wù)平臺(tái) 獲取隨機(jī)數(shù)請(qǐng)求 getRandom3rd Server KLTX 注冊(cè)回調(diào)地址請(qǐng)求 setCallBackAddr3rd Server KLTX 注冊(cè) 接口 回調(diào)地址更改報(bào)告 notifyStatusKLTX 3rd Server 發(fā)起 CTD 呼叫請(qǐng)求 dialCall3rd Server KLTX 發(fā)起 CTD 呼叫結(jié)果 報(bào)告 notifyStatusKLTX 3rd Server 終止 CTD 呼叫請(qǐng)求 releaseCall3rd Server KLTX 呼叫終止結(jié)果報(bào)告 notifyStatusKLTX 3rd Server CTD 接口 查詢 CTD 呼叫請(qǐng)求 getCallStatus3rd Server KLTX 發(fā)起會(huì)議請(qǐng)求 createConf3rd Server KLTX 發(fā)起會(huì)議結(jié)果報(bào)告 notifyStatusKLTX 3rd Server 查詢會(huì)議列表 getConfList3rd Server KLTX 查詢指定 ID 會(huì)議室 信息 getConfInfo3rd Server KLTX 查詢指定 ID 會(huì)議室 的與會(huì)成員 getConfMember3rd Server KLTX 主持人邀請(qǐng)與會(huì)者 請(qǐng)求 addIntoConf3rd Server KLTX 主持人斷開與會(huì)者 請(qǐng)求 delFromConf3rd Server KLTX 主持人結(jié)束會(huì)議請(qǐng) 求 releaseConf3rd Server KLTX 與會(huì)者進(jìn)入會(huì)議通 知 notifyStatusKLTX 3rd Server 與會(huì)者退出會(huì)議通 知 notifyStatusKLTX 3rd Server CTC 接口 會(huì)議結(jié)束通知 notifyStatusKLTX 3rd Server 發(fā)送短信請(qǐng)求 SendSMS3rd Server KLTX 發(fā)送短信結(jié)果報(bào)告 NotifyStatusKLTX 3rd Server 發(fā)送短信回執(zhí) EchoOfSendSMSKLTX 3rd Server 收發(fā) 短信 接收短信請(qǐng)求 RecvSMSKLTX 3rd Server 第三方合作商應(yīng)用平臺(tái)調(diào)用寬樂通信業(yè)務(wù)平臺(tái)WebService 接口的典型 流程如下 1 第三方應(yīng)用平臺(tái)調(diào)用寬樂通信業(yè)務(wù)平臺(tái)的GetRandom獲取校驗(yàn)用的隨機(jī) 數(shù) 2 第三方應(yīng)用平臺(tái)用隨機(jī)數(shù)與登錄密碼加密后 向?qū)挊吠ㄐ艠I(yè)務(wù)平臺(tái)發(fā) 起注冊(cè)回調(diào)地址請(qǐng)求SetCallBackAddr 該請(qǐng)求攜帶回調(diào)地址參數(shù)指明第三方服 務(wù)器對(duì)寬樂通信業(yè)務(wù)平臺(tái)開放的WebService接口的IP地址 URL和端口 寬樂通 信業(yè)務(wù)平臺(tái)對(duì)帳號(hào)密碼鑒權(quán)通過后注冊(cè)該帳號(hào)及對(duì)應(yīng)的回調(diào)服務(wù)信息 生成一 個(gè)連接id返回給第三方服務(wù)器 該連接id在第三方服務(wù)器后續(xù)的請(qǐng)求中攜帶 一個(gè)帳號(hào)只能創(chuàng)建一個(gè)連接 最新的注冊(cè)將使以前注冊(cè)的回調(diào)地址信息失效 3 第三方應(yīng)用平臺(tái)重新調(diào)用寬樂通信業(yè)務(wù)平臺(tái)的GetRandom獲取校驗(yàn)用的 隨機(jī)數(shù) 并用該隨機(jī)數(shù)加密DialCall接口調(diào)用的寬樂通信帳號(hào)和密碼 4 第三方應(yīng)用平臺(tái)調(diào)用寬樂通信業(yè)務(wù)平臺(tái)CTD呼叫請(qǐng)求DialCall接口 鑒 權(quán)通過后寬樂通信業(yè)務(wù)平臺(tái)服務(wù)器同步返回CTD會(huì)話id 5 寬樂通信業(yè)務(wù)平臺(tái)根據(jù)CTD請(qǐng)求攜帶的主被叫號(hào)碼發(fā)起CTD呼叫 首先 呼通主叫 然后呼通被叫 接通主被叫 在此過程中 寬樂通信業(yè)務(wù)平臺(tái)通過 調(diào)用NotifyStatus接口向第三方應(yīng)用平臺(tái)上報(bào)正在接續(xù)主叫 接通主叫 呼叫 建立開始通話等事件 6 寬樂通信業(yè)務(wù)平臺(tái)監(jiān)控到主叫或被叫掛機(jī) 呼叫結(jié)束時(shí) 將通過 NotifyStatus接口向第三方應(yīng)用平臺(tái)上報(bào)呼叫結(jié)束事件 7 呼叫結(jié)束前 第三方應(yīng)用平臺(tái)可通過CTD會(huì)話id調(diào)用ReleaseCall終止呼 叫 典型的交互流程如下圖所示 GetRandom rand SetCallBackAddr Connectionid GetRandom rand DialCall Sessionid NotifyStatus NotifyStatus NotifyStatus NotifyStatus 第三方應(yīng)用平臺(tái)ZYTX平臺(tái) 2 2 接口定義說明接口定義說明 以下可選項(xiàng) 可以填空字符串 對(duì)于寬樂通信業(yè)務(wù)平臺(tái)各業(yè)務(wù)能力服務(wù)調(diào)用時(shí)的數(shù)據(jù)填充以及對(duì)返回結(jié)果 請(qǐng)嚴(yán)格遵 守如下相關(guān)規(guī)范說明和定義 2 2 1 注冊(cè)接口注冊(cè)接口 2 2 1 1 獲取隨機(jī)數(shù) 接口說明 第三方服務(wù)器通過該接口獲取對(duì)后續(xù)請(qǐng)求加密的隨機(jī)數(shù) 每次調(diào)用其他函 數(shù) 都需要先調(diào)用該函數(shù)獲取新的隨機(jī)數(shù) 接口格式 String GetRandom 輸入?yún)?shù)說明 無(wú) 返回參數(shù)說明 參數(shù)類型必選 可 選 說明 randString必選成功返回大于0 的 隨機(jī)數(shù) 失敗返回 1 2 2 1 2 注冊(cè) 更改回調(diào)地址 接口說明 該接口用于第三方服務(wù)器注冊(cè)它的回調(diào) WebService 接口的地址 獲取連接 id 接口格式 String SetCallbackAddr String uc String pw String rand String url 輸入?yún)?shù)說明 參 數(shù) 類型必選 可選 說明 ucString必選寬樂通信業(yè)務(wù)系統(tǒng)分配給第三方應(yīng)用平臺(tái) 注冊(cè)WebService 的用戶號(hào)碼 pwString必選 GetRandom 獲取的rand 參數(shù) 寬樂通信 帳號(hào)密碼 寬樂通信帳號(hào)密碼 經(jīng)過MD5 加密 后的字符串 以下加密方式相同 randString必選隨機(jī)數(shù) urlString必選回調(diào)服務(wù)器的url 完整的WebService 訪 問地址 如 http 102 71 103 47 8080 jboss net services Callback 返回參數(shù)說明 參數(shù)類型必選 可 選 說明 connIDString必選代表一個(gè)第三方應(yīng) 用平臺(tái)與寬樂通信業(yè)務(wù) 平臺(tái)間的連接 第三方 應(yīng)用平臺(tái)調(diào)用寬樂通信 業(yè)務(wù)平臺(tái)WebService接 口時(shí)攜帶連接id 寬樂 通信業(yè)務(wù)平臺(tái)根據(jù)連接 id 確定回調(diào)地址 返回值 0 為連接 通道ID 0 成功返回 返回值為呼叫標(biāo)識(shí) 0 成功返回 表示為會(huì)議標(biāo)識(shí) 0 失敗碼 同通用失敗碼 2 2 3 2 ReleaseConf 接口說明 用戶用來(lái)終止自己發(fā)起的會(huì)議 通過寬樂通信業(yè)務(wù)平臺(tái)釋放指定的會(huì)場(chǎng) 接口格式 String releaseConf String uc String pw String rand String confID 輸入?yún)?shù)說明 參數(shù)類型必 選 可選 說明 ucString必 選 本次會(huì)議使用的寬樂通信號(hào)碼 pwString必 選 GetRandom 獲取的rand 參數(shù) 寬樂通信帳號(hào)密碼 寬樂通信帳號(hào) 的密碼 經(jīng)過MD5 加密后的字符串 以下加密方式相同 randString必 選 隨機(jī)數(shù) confIDString必 選 需釋放的會(huì)議ID 返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 resSt ring 必 選 返回碼說明 0 成功返回 其他同通用失敗碼 2 2 3 3 GetConfInfo 接口說明 用戶用來(lái)終止自己發(fā)起的會(huì)議 通過寬樂通信業(yè)務(wù)平臺(tái)釋放指定的會(huì)場(chǎng) 接口格式 String getConfInfo String uc String pw String rand String confID 輸入?yún)?shù)說明 參數(shù)類型必 選 可選 說明 ucString必 選 本次會(huì)議使用的寬樂通信號(hào)碼 pwString必 選 GetRandom 獲取的rand 參數(shù) 寬樂通信帳號(hào)密碼 卓寬樂通信帳 號(hào)的密碼 經(jīng)過MD5 加密后的字符 串 以下加密方式相同 randString必 選 隨機(jī)數(shù) confIDString必 選 需查詢的會(huì)議ID 返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 resSt ring 必 選 返回碼說明 0 成功返回 其他同通用失敗碼 sbjSt ring 可 選 會(huì)議主題 BASE64 編碼后的字符 串 startSt ring 必 選 會(huì)議開始時(shí)間 格式 hhmmss 時(shí)分 秒6 位字符串 pwSt ring 可 選 會(huì)議密碼 CerSt ring 必 選 會(huì)議主持人 szSt ring 必 選 業(yè)務(wù)級(jí)的會(huì)場(chǎng)最大方數(shù) bgfSt ring 必 選 會(huì)議屬性1 保留 bgSt可會(huì)議屬性2 保留 ring選 recSt ring 必 選 會(huì)議屬性4 保留 tpSt ring 可 選 會(huì)場(chǎng)類型 0 普通會(huì)議 conf state St ring 必 選 會(huì)場(chǎng)的狀態(tài) 0 初始化中 正在創(chuàng) 建一個(gè)會(huì)議 不允許接受事務(wù)請(qǐng)求 1 創(chuàng)建會(huì)議成功正在加入其他與會(huì) 者 不允許接受事務(wù)請(qǐng)求 2 會(huì)議中 允許接受事務(wù)請(qǐng)求 創(chuàng) 建會(huì)議成功 與會(huì)者加入完成后 為該 狀態(tài) 3 結(jié)束會(huì)議 或者業(yè)務(wù)邏輯結(jié)束會(huì) 議 主持人退出 時(shí)為該狀態(tài) 備注 返回值說明 返回的數(shù)組格式為 res ConfID sbj start pw Cer sz bgf bg rec tp conf state 2 2 3 4 GetConfMember 接口說明 用戶查看指定會(huì)議的與會(huì)者信息 接口格式 String getConfMember String uc String pw String rand String confID 輸入?yún)?shù)說明 參數(shù)類型必 選 可選 說明 ucString必 選 本次會(huì)議使用的寬樂通信號(hào)碼 pwString必 選 GetRandom 獲取的rand 參數(shù) 寬樂通信帳號(hào)密碼 寬樂通信帳號(hào) 的密碼 經(jīng)過MD5 加密后的字符串 以下加密方式相同 randString必 選 隨機(jī)數(shù) confIDString必 選 會(huì)議ID 返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 resSt ring 必 選 返回碼 0 成功返回 其他同通用 失敗碼 numSt ring 必 選 與會(huì)者個(gè)數(shù) ceeSt ring 必 選 與會(huì)者號(hào)碼 stat e St ring 必 選 與會(huì)者狀態(tài) 1 會(huì)議中 3 與會(huì)者保持會(huì)議 autSt ring 必 選 與會(huì)者屬性1 保留 Ca llInfo tim e St ring 必 選 與會(huì)者加入時(shí)間HHMMSS 備注 返返回?cái)?shù)組的格式為 res num Ceeinfo1 Ceeinfo2 其中 CeeInfo cee state aut time 2 2 3 5 GetConfList 接口說明 用于查看該UC 號(hào)碼正在進(jìn)行中的會(huì)議 接口格式 String getConfList String uc String pw String rand 輸入?yún)?shù)說明 參 數(shù) 類 型 必 選 可 選 說明 ucSt ring 必 選 本次會(huì)議使用的寬樂通信號(hào)碼 pwSt ring 必 選 GetRandom 獲取的rand 參數(shù) 寬樂通信 帳號(hào)密碼 寬樂通信帳號(hào)的密碼 經(jīng)過MD5 加 密后的字符串 以下加密方式相同 ra nd St ring 必 選 隨機(jī)數(shù) 返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 resSt ring 必 選 返回碼 0 成功返回 其他同通用 失敗碼 numSt ring 必 選 會(huì)議個(gè)數(shù) 如果返回碼為失敗碼 該參數(shù)為null confIDSt ring 必 選 會(huì)場(chǎng)ID 備注 返回?cái)?shù)組格式為 res num confID1 confID2 confID3 2 2 3 6 AddIntoConf 接口說明 用于邀請(qǐng)其他人員加入指定會(huì)議 接口格式 String addIntoConf String uc String pw String rand String nums String confID 輸入?yún)?shù)說明 參數(shù)類型必 選 可 選 說明 ucString必 選 本次會(huì)議使用的寬樂通信號(hào)碼 pwString必 選 GetRandom 獲取的rand 參數(shù) 寬樂通信帳號(hào)密碼 寬樂通信帳號(hào)的密 碼 經(jīng)過MD5 加密后的字符串 以下 加密方式相同 randString必 選 隨機(jī)數(shù) c ee S tring 必 選 待加入的與會(huì)者號(hào)碼 a ut S tring 必 選 與會(huì)者屬性1 保留 固定取值1 nums 邀請(qǐng)參 與會(huì)議的相 關(guān)人員 nums cell1 cell2 其中 cell cee aut pwd p wd S tring 必 選 與會(huì)者屬性2 保留 取值空 confIDString必 選 會(huì)場(chǎng)ID 返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 resSt ring 必 選 返回碼 0 成功返回 其他同通用 失敗碼 失敗碼 返回成功表示UC 號(hào) 碼鑒 權(quán)成功以及會(huì)議鑒權(quán)成功 準(zhǔn)備添 加與會(huì)者 與會(huì)者添加成功與否通 過NotifyStatus 上報(bào)狀態(tài) 失敗碼說明 0 成功返回 其他同通用失敗碼 2 2 3 7 DelFromConf 接口說明 會(huì)議主持人使與會(huì)者離開指定的會(huì)議 接口格式 String delFromConf String uc String pw String rand String cee String confID 輸入?yún)?shù)說明 參數(shù)類型必 選 可 選 說明 ucString必本次會(huì)議使用的寬樂通信號(hào)碼 選 pwString必 選 GetRandom 獲取的rand 參數(shù) 寬樂通信帳號(hào)密碼 寬樂通信帳號(hào)的密 碼 經(jīng)過MD5 加密后的字符串 以下 加密方式相同 randString必 選 隨機(jī)數(shù) ceeString必 選 待踢出的與會(huì)者號(hào)碼 confIDString必 選 會(huì)場(chǎng)ID 返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 resSt ring 必 選 返回碼 0 成功返回 其他同通用 失敗碼 2 2 4SendSMS 短信相關(guān)接口短信相關(guān)接口 2 2 4 1 SendMsg 接口說明 第三方服務(wù)器可以通過該接口使用 UC 號(hào)碼發(fā)送短信 該接口同步返回請(qǐng)求結(jié)果 如果 UC 系統(tǒng)接受此請(qǐng)求則返回發(fā)送短信對(duì)應(yīng)的會(huì)話 id 作 為該發(fā)送短信請(qǐng)求后續(xù)的事件上報(bào)的識(shí)別 id 如果失敗則返回錯(cuò)誤信息 發(fā)送短信的狀態(tài)將通過NotifyStatus調(diào)用異步返回給第三方服務(wù)器 接口格式 String SendSMS String uc String pw String rand String callee String isreturn String cont int msgid String connID 輸入?yún)?shù)說明 參數(shù)類型必選 可選說明 ucString 必選寬樂通信業(yè)務(wù)平臺(tái)分配給第三方服務(wù)器 發(fā)起 WebService 呼叫的用戶號(hào)碼 本次呼叫的使用的寬樂通信業(yè)務(wù)號(hào)碼 費(fèi)用記在該寬樂通信業(yè)務(wù)號(hào)碼號(hào)碼上 pwString 必選寬樂通信業(yè)務(wù)號(hào)碼號(hào)碼對(duì)應(yīng)的密碼 MD5 加密 randString 必選隨機(jī)數(shù) callee String 必選被叫號(hào)碼 帶區(qū)號(hào) 可以帶多個(gè)被叫號(hào) 碼 iseturnString 必選該短信是否需要回執(zhí) 0 不需要回執(zhí) 1 需要回執(zhí) contString 可選短信內(nèi)容 msgidint 必選由第三方生成的短信的標(biāo)識(shí) 第三方級(jí) 唯一 connIDString 必選連接通道 ID 說明 Callee Callee1 Callee2 返回參數(shù)說明 參數(shù)參數(shù)類型類型必選必選 可選可選說明說明 resString必選 返回值說明 0 成功返回 0 失敗碼如下 失敗碼說明 1 發(fā)送短信失敗 2 2 4 22 2 4 2notifySmsReceipt 接口說明 如果發(fā)送的短信被第三方用戶收到 會(huì)為短信發(fā)送用戶提供短信回執(zhí) 第三方服務(wù)器 需要提供發(fā)送短信回執(zhí)接口接收短信回執(zhí) 接口格式 Void EchoOfSendSMS String ucNum String cee int msgid int res String recvt 輸入?yún)?shù)說明 參數(shù)參數(shù)類型類型必選必選 可選可選說明說明 ucNumString 必選發(fā)送方號(hào)碼 用于第三方服務(wù)器定位發(fā) 送客戶端 ceeString 必選接收方號(hào)碼 msgidint 必選短消息編號(hào) 用于客戶端匹配請(qǐng)求 消息 resint 必選回執(zhí)的結(jié)果 recvtString 必選短消時(shí)間 回執(zhí)的結(jié)果說明 1 接收方成功接收短信 1 系統(tǒng)異常 12 系統(tǒng)超時(shí) 2 2 4 32 2 4 3recvMsgrecvMsg 接口說明 第三方服務(wù)器需要提供接收短信 WebService 接口接收在其上登記的寬樂通信業(yè)務(wù)號(hào) 碼號(hào)碼的短信 該接口同步返回結(jié)果 如果第三方服務(wù)器成功接收短信 將結(jié)果立即返回 接口格式 String RecvSMS String caller String time String cont String ucNum 輸入?yún)?shù)說明 參數(shù)參數(shù)類型類型必選必選 可選可選說明說明 callerString 必選短信的發(fā)送者號(hào)碼 timeString 必選短信發(fā)送時(shí)間 以 http 接口傳過來(lái)的 時(shí)間為準(zhǔn) contString 必選短信內(nèi)容 ucNumString 必選短信接收者號(hào)碼 接收短信的 UC 號(hào)碼 返回參數(shù)說明 參數(shù)參數(shù)類型類型必選必選 可選可選說明說明 resString 必選 返回值說明 0 成功返回 0 失敗碼 失敗碼說明 1 接收失敗 2 2 5 第三方服務(wù)器需要實(shí)現(xiàn)通用回調(diào)函數(shù)第三方服務(wù)器需要實(shí)現(xiàn)通用回調(diào)函數(shù) 接口說明 第三方服務(wù)器需要實(shí)現(xiàn)NotifyStatus 函數(shù)用于接收相關(guān)參數(shù)并對(duì)相關(guān)參數(shù)進(jìn) 行處理 接口格式 void NotifyStatus int eventID String sessionID int res String para1 輸入?yún)?shù)說明 參數(shù)類 型 必 選 可選 說明 eventIDi nt 必 選 接口事件ID 區(qū)別相應(yīng)接口調(diào)用返回 以及對(duì)其他事件的上報(bào) sessionI D S tring 必 選 呼叫標(biāo)識(shí) 會(huì)議標(biāo)識(shí) 當(dāng)eventID為短 信事件ID 13時(shí) 該字段值為短信 msgID resS tring 必 選 失敗碼 狀態(tài)碼 para1S tring 可 選 參數(shù)1 其與具體回調(diào)事件相關(guān) 請(qǐng) 參見回調(diào)事件的具體說明 2 2 5 1設(shè)置回調(diào)地址回調(diào)事件 部分返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 eventIDi nt 必 選 1 para1S tring 可 選 resS tring 狀態(tài)碼說明 1 回調(diào)地址發(fā)生更改 失敗碼說明 1 系統(tǒng)異常 2 2 5 2發(fā)起 CTD 呼叫回調(diào)事件 返回參數(shù)說明 參數(shù)類必說明 型選 可選 eventIDi nt 必 選 2 para1S tring 可 選 resS tring 狀態(tài)碼說明 1 正在接通主叫 2 成功接通主叫 正在接通被叫 3 呼叫建立 開始通話 失敗碼說明 1 系統(tǒng)異常 8 UC 余額或月限額不足 12 系統(tǒng)超時(shí) 13 主叫無(wú)法接通 包括掛機(jī) 未激 活 14 被叫無(wú)法接通 包括掛機(jī) 未激 活 17 主叫忙 18 被叫忙 19 主叫無(wú)應(yīng)答 20 被叫無(wú)應(yīng)答 24 保留 25 保留 41 發(fā)起者未激活 2 2 5 3呼叫釋放回調(diào)事件 部分返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 eventIDi nt 必 選 3 para1S tring 可 選 resS tring 狀態(tài)碼說明 1 呼叫結(jié)束成功 失敗碼說明 1 系統(tǒng)異常 2 2 5 4多方會(huì)議回調(diào)事件 2 2 5 4 1發(fā)起多方會(huì)議回調(diào)事件 部分返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 eventIDi nt 必 選 4 para1S tring 可 選 resS tring 必 選 狀態(tài)碼說明 1 正在接通主持人 2 主持人加入會(huì)議 失敗碼說明 1 系統(tǒng)異常 11 發(fā)起者UC號(hào)碼不存在 12 發(fā)起者狀態(tài)未激活 13 發(fā)起者余額或月限額不足 14 發(fā)起者未訂閱此功能 15 主持人鑒權(quán)失敗 16 主持人忙 17 主持人無(wú)應(yīng)答 18 路由主持人失敗 2 2 5 4 2與會(huì)者進(jìn)入會(huì)議回調(diào)事件 部分返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 eventIDi nt 必 選 5 para1S tring 可 選 與會(huì)者號(hào)碼 resS tring 必 選 狀態(tài)碼說明 0 與會(huì)者加入會(huì)議 失敗碼說明 1 系統(tǒng)異常 加入失敗 2 會(huì)場(chǎng)已滿 3 用戶已在會(huì)場(chǎng)中 4 用戶類型不正確 8 主持人余額或月限額不足 會(huì)議 期間費(fèi)用被扣完 22 保留 61 與會(huì)者無(wú)法接通 17 與會(huì)者忙 18 與會(huì)者無(wú)應(yīng)答 2 2 5 4 3與會(huì)者退出會(huì)議回調(diào)事件 部分返回參數(shù)說明 參數(shù)類 型 必 選 可選 說明 eventIDi nt 必 選 6 para1S tring 可 選 與會(huì)者號(hào)碼