REST API:語音文件上傳
通過HTTPS POST方式提交請求,云通訊平臺收到請求后,將語音文件上傳到服務器。
注:目前語音文件上傳功能僅提供給生產環境的上線應用使用。
1、請求
1.1 請求地址
/{SoftVersion}/Accounts/{accountSid}/Calls/MediaFileUpload
1.2 請求包頭
請參閱:Rest 介紹》統一請求包頭,使用主賬戶進行驗證
1.3 請求包體
屬性 | 類型 | 約束 | 說明 |
---|---|---|---|
appid | String | 必選 | 應用Id |
filename | String | 必選 | 文件名(包含擴展名) ,支持wav或zip(將多個語音文件打包)格式,最大限制為20M。 |
1.4 XML請求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz123456/Calls/MediaFileUpload?sig=3504A2F48AB 6328BF33AC70302C4A0C0&appid=ff8ss9090sdafh0sa0f89s0a7fd09ahfa&filename=marking.wav HTTP/1.1 Host:192.168.0.1:8883 content-length: 1390 Accept:application/xml; Content-Type:application/octet-stream;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTA2MzA= <二進制數據>
1.5 JSON請求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz123456/Calls/MediaFileUpload?sig=3504A2F48AB 6328BF33AC70302C4A0C0&appid=ff8ss9090sdafh0sa0f89s0a7fd09ahfa&filename=marking.wav HTTP/1.1 Host:192.168.0.1:8883 content-length: 1390 Accept:application/json; Content-Type:application/octet-stream;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTA2MzA= <二進制數據>
2、響應
2.1 響應包體
屬性 | 類型 | 約束 | 說明 |
---|---|---|---|
statusCode | String | 必選 | 請求狀態碼,取值000000(成功),可參考Rest 錯誤代碼。 |
downloadUrl | String | 必選 | 上傳語音文件返回的下載地址,用于驗證上傳文件正確性。目前不支持zip格式驗證。 |
注意:語音文件上傳成功后,默認是在審核狀態,審核完成后方可使用,審核狀態可通過網站查看。如要開啟免審核,請聯系售前人員。
2.2 XML請求示例
HTTP/1.1 200 OK Content-Length: 574 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response> <statusCode>000000</statusCode> </Response>
2.3 JSON請求示例
HTTP/1.1 200 OK Content-Length: 574 {"statusCode":"000000"}
文檔更新時間:2016年10月17日