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日