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