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