1、作者最后修改時間API 版本有信2016-03-181.0.0 版有信崔江寧2016/3/24源通訊開放API 介紹1環境準備31.1接入流程32API 介紹42.1 獲取 token 接口42.2 用戶信息更新接口(未發布,后面可能會微調)62.2 Http 方式的回撥接口82.2.1地址82.2.2 調用參數說明：82.2.3 返回參數說明92.1.4 http 請求加密111環境準備1.1 接入流程1.登錄有信開放上你的 APP 應用，之后有信開放會為您的應用分配 ap、簽名私鑰等必要參數。2.有信源通訊 SDK（Android 版或 iOS 版），并將 SDK 集成進您的應用。（參見客

2、戶端SDK 集成文檔）。3.第Server 需向您的App 開放一個獲取 token 的接口，第Server 只會涉及與有信Server 之間的通信，具體交互方式請參見交互流程圖。4.第APP、第Sever、有信 Server 聯調測試。5.應用上線。第Server：貴公司自己的后端服務器。有信 Server： 有信源通訊服務器。源通訊 SDK:用于集成到APP 客戶端，有信開放語音通話能力的API。交互流程如下：API 介紹獲取 TOKEN 接口有信 Server 提供的獲取token 的HTTP 接口，URL 為 h/ams/reg請求參數：參數名稱是否必須說明sn流水號Y生成方法：sn=

3、 當前時間戳+ 6 位數的隨機數pvY1：android 2:ios 3:其他osv客戶端系統版本Yappv第app 版本Yapiv接口版本號Yap第idYsign簽名Y（參見sign 簽名生成算法）accountid 第用戶賬號Y第應用的用戶賬號，唯一標示sign 簽名生成算法案例URL1&osv=4.4.1&appv=1.1&apiv=1&imei=fe9784fa556245266e6a9&sign=d12fbf0a982a3d6711afe9784fa556245266e6a9&nickname=111&imgurl =111返回結果JSON：result: 0,msg:, info:

4、token:x結果說明:&ap=meizu&sn=52523&pv=取出所有參數值，按小寫字母序由小到大排列得到paramslist；將paramslist 拼接為一個字符串，得到paramsstring；將appkey 作為salt 拼接到paramsstring 后邊，得到paramsstringkey；用sha1 算法對paramsstringkey 做簽名得到sign；phone號N號nickname 用戶昵稱Nimgurl頭像N2.2 用戶信息更新接口(未發布,后面可能會微調)請求參數：參數名稱是否必須說明sn流水號Y生成方法：sn= 當前時間戳+ 6 位數的隨機數pvY1：andr

5、oid 2:ios 3:其他osv客戶端系統版本Yappv第app 版本Yapiv接口版本號Yap第idYsign簽名Y（參見sign 簽名生成算法）值說明result 0：成功，其他：失敗，詳細待定msg結果說明，通常為空info結果數據，json 格式，包括：token，可擴展2523&pv=1&osv=4.4.1&appv=1.1&apiv=1&imei=fe9784fa556245266e6a9&sign=d12fbf0a982a3d6711afe9784fa556245266e6a9&nickname=111& imgurl =111返回結果JSON：值說明result 0：成功，其

6、他：失敗，詳細待定msg結果說明，通常為空result: 0,msg:,結果說明:&ap=meizu&sn=5accountid 第用戶賬號Y第應用的用戶賬號，唯一標示nickname 用戶昵稱Yimgurl頭像Y2.3 HTTP 方式的回撥接口2.3.1測試環境：地址其中，支持 get,也支持t.其中t 支持參數加密，下面會詳細介紹支持參數加密的方式調用。2.3.2 調用參數說明：參數參數類型是否必須備注ap字符串 String必選accountid字符串 String必選pv字符串 String必選常規參數，譬如：4.4.1osv字符串 String必選常規參數，譬如：1.1appv字符串

7、 String必選常規參數，譬如：1apiv字符串 String必選常規參數，譬如：1sn字符串 String必選序列號，常規參數，譬如：123412343124caller字符串 String必選主叫號碼。必填信息，呼出方號碼，該 號碼需要為真實有效得 號碼?？梢詾?號碼和座機號碼。譬如：called字符串 String必選被叫號碼：必填信息，接入方號碼，目前被叫方需要支持號碼、座機號碼以及 400 號碼三種類2.3.3 返回參數說明data:callid:8e668f249b0743deb6d579f52e463888,msg:BALANCE_ENOUGH,phonelistver:3,r

8、esult:0,whitefilterver:2簽名算法：參數類型說明result整形0:成功。其它是錯誤代碼，想看msg 字段msg字符串提示信息phonelistver字符串鏈表版本。whitefilterver字符串白過濾版本callid字符串該通的 id。僅 result=0才有。型號碼呼叫，不支持臺以及國際號碼。譬如：showCaller字符串 String可選主叫顯示號碼：選填信息。showCalled字符串 String可選被叫顯示號碼：選填信息tflag整形可選是否。選填信息（ 0 關閉，1 開啟）mt整形可選最大通話時間。整形sign字符串 String必選簽名驗證信息。si

9、gn 的生成規則：針對參數進行排序后，用appkey 進行加密。代碼片段如下：public sic String getSign(String appkey, Map map) if (map = null | map.size() = 0) return ;List list = new ArrayList();for (Mntry entry : m String key = entry.getKey(); String value = entry.getValue();ntrySet() if (!sign.equals(key) & value != null & !.equals(v

10、alue)& !true.equalsIgnoreCase(value) list.add(value);Collections.sort(list, new Comparator() Overridepubliccompare(String v1, String v2) return v1.toLowerCase().compareTo(v2.toLowerCase(););System.out.prln(list);StringBuilder signSrc = new StringBuilder();for (String value : list) signSrc.append(val

11、ue);signSrc.append(appkey); System.out.prln(signSrc.toString();String sha1Sign = UXDecript.SHA1(signSrc.toString();return sha1Sign;2.3.4 http 請求加密Http 方式的回撥，提供和不。其中不，支持t,和Get。只支持t.URL ：對參數加密。加密算法：Map map = initParmater(); / 需要請求的參數String jsonString = JSONObject.toJSONString(map); /序列化String dataJson

12、 = DesUtils.encryptBasedDes(appKey, jsonString); /加密String json = HttpUtils.httptWithJSON(ycbUrl, dataJson); /發送t 請求。發送t 請求：/*數據加密，算法（DES）*param data要進行加密的數據return 加密后的數據*/public sic String encryptBasedDes(String key, String data) String encryptedData = null;try / DES算法要求有一個任的隨機數源SecureRandom sr = n

13、ew SecureRandom();DESKeySpec deskey = new DESKeySpec(key.getBytes();/ 創建一個密匙工廠，然后用它把DESKeySpec轉換成一個SecretKey對象 SecretKeyFactory keyFactory = SecretKeyFactory.getInstance(DES); SecretKey secretKey = keyFactory.generateSecret(deskey);/ 加密對象Cipher cipher = Cipher.getInstance(DES); cipher.init(Cipher.EN

14、CRYPT_MODE, secretKey, sr);/ 加密，并把字節數組編碼成字符串encryptedData = newsun.misc.BASE64Encoder().encode(cipher.doFinal(data.getBytes(); catch (Exception e) / log.error(加密錯誤，錯誤信息：, e);throw new RuntimeException(加密錯誤，錯誤信息：, e);return encryptedData;public sic String httptWithJSON(String url, String json) throws

15、 Exception / 將JSON進行UTF-8編碼,以便傳輸中文String encoderJson = URLEncoder.encode(json, HTTP.UTF 8);DefaultHttpCnt httpCnt = new DefaultHttpCnt();Httphttpt httpt = new Httpt(url);t.addHeader(HTTP.CONTENT_TYPE, APPLICATION_JSON);StringEntity se = new StringEntity(encoderJson);se.setContentType(CONTENT_TYPE_TE

16、XT_JSON);se.setContentEncoding(new BasicHeader(HTTP.CONTENT_TYPE, APPLICATION_JSON);httpt.setEntity(se);HttpResponse response = httpCnt.execute(httpHttpEntity entity = response.getEntity();t);System.out.prln(response.getSif (entity != null) usLine();System.out.prln(Response content length: + entity.

17、getContentLength();/ 顯示結果BufferedReader reader = new BufferedReader(new InputStreamReader(entity.getContent(), UTF-8);StringBuffer sb = new StringBuffer(); String line = null;while (line = reader.readLine() != null) System.out.prln(line); sb.append(line);if (entity != null) entity.consumeContent();return sb.toString();2.4 實時通話回調接口一. 準備工作：需要第應用接入的時候，提供一個URI。那么，當每通結束后，源通訊通過這個uri 返回相關的通話信