深圳市深海捷科技有限公司研發(fā)的企業(yè)級(jí)呼叫中心系統(tǒng)具有完善的第三方開(kāi)發(fā)接口，第三方信息系統(tǒng)開(kāi)發(fā)/集成商可以通過(guò)很小的工作量集成深海捷呼叫中心功能，比如來(lái)電/去電彈屏、點(diǎn)擊撥號(hào)等。
本文主要描述深海捷呼叫中心系統(tǒng)第三方開(kāi)發(fā)接口及規(guī)范，主要閱讀人員為第三方CRM、ERP、信息管理系統(tǒng)等開(kāi)發(fā)商以及具備二次開(kāi)發(fā)能力的客戶。
本文所描述的第三方開(kāi)發(fā)接口適用于B/S架構(gòu)及C/S架構(gòu)的程序開(kāi)發(fā)商，讀者可以選擇自己感興趣的部分進(jìn)行閱讀。
1. 接口介紹
1.1 服務(wù)基地址
呼叫中心提供的 API 請(qǐng)求服務(wù)地址稱(chēng)之為服務(wù)基地址（下文中使用變量{BaseUrl}表示），{BaseUrl}為系統(tǒng)的登錄地址, 可以是域名或者ip, 根據(jù)實(shí)際情況, 可能還需要加上目錄. 如: http://120.1.1.1/admin/
實(shí)際提供的接口服務(wù)請(qǐng)求地址為'http://{BaseUrl}+[接口服務(wù)名]'。
1.2 接入認(rèn)證
業(yè)務(wù)提供的 API 均采用加密認(rèn)證方式。
此種認(rèn)證方式下，將根據(jù)私有的 AppSecret 生成加密碼進(jìn)行鑒權(quán)。鑒權(quán)通過(guò)后，語(yǔ)音平臺(tái)處理該請(qǐng)求消息。
說(shuō)明：
AppKey 和 AppSecret可以在管理后臺(tái)進(jìn)行配置
1.3 加密規(guī)則
1. 獲取所有的需要傳遞的參數(shù)，作為一個(gè)數(shù)組
2. 將加密數(shù)組中所有的 key 轉(zhuǎn)換成小寫(xiě)
3. 排除參數(shù)列表中的 sign 和值為空的數(shù)據(jù)，即 sign 的值和空數(shù)據(jù)不參與加密
4. 對(duì)參數(shù)數(shù)組進(jìn)行排序，按照 key 的名稱(chēng)升序排列
5. 遍歷參數(shù)數(shù)組，將值進(jìn)行拼接
6. 在拼接后的字符串后面再連接私有的秘鑰，拼接后的字符串表示為$string
7. 采用 sha1 進(jìn)行加密，規(guī)則 sha1($string . sha1($secret)), $string 代表拼接后的字符串，$secret 代表私有秘鑰
8. 將生成的 sign 轉(zhuǎn)換為小寫(xiě)