语音文件上传
- 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=3504A2F48AB6328BF33AC70302C4A0C0&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=3504A2F48AB6328BF33AC70302C4A0C0&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"}