语音文件包含上传和下载。
上传的语音文件是用于呼叫中心的各种语音播放,比如呼入彩铃,转坐席的保持音以及入队等待音。
该语音文件可以通过两种方式上传:
1、通过开发者账户管理页面的ivr语音文件上传页面上传。
2、通过语音文件上传接口上传。
下载的语音文件主要是在通话过程中产生的录音文件,或者是用户留言的语音文件。
该节包含以下接口:
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
sid | String | 必选 | 主账户id,ucpaas平台生成,固定32位长度,可在开发者控制台查询 |
appId | String | 必选 | 应用唯一标识 |
token | String | 必选 | 主账号授权令牌token,可在开发者控制台查询 |
time | String | 必选 | 时间戳,当前系统时间( 24小时制),格式:yyyyMMddHHmmssSSS |
sign | String | 必选 | 验证信息,使用MD5加密(主账户id+时间戳+账户授权令牌),共32位(小写) |
file | multipart/form-data | 必选 | 语音文件,以文件流的形式上传,格式:MP3、wav,不能超过5MB,文件名字不能为中文,仅支持ascii码字符文件名 |
POST 请求
POST 请求
POST /fileserver/recordFileUpload HTTP/1.1 HOST: www.ucpaas.com Content-Lenth: 18306 ContentType: multipart/form-data; boundary=aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942 Content-Disposition: form-data; name="sid" 12345678901234567890abcdefghijk0 --aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942 Content-Disposition: form-data; name="appId" 987654325810qwertyuiop --aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942 Content-Disposition: form-data; name="token" abcdefghijklmnopkrstuvwxyz123456 --aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942 Content-Disposition: form-data; name="file"; filename="C:/Users/2pn7p02/Music/yzxwait.wav" Content-Type: application/octet-stream ... --aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942--
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
sid | String | 必选 | 主账户id,ucpaas平台生成,固定32位长度,可在开发者控制台查询 |
token | String | 必选 | 主账号授权令牌token,可在开发者控制台查询 |
fileid | string | 必选 | 通话结束时返回的fileidName字段携带的值 |
date | string | 必选 | 通话结束时返回的date字段携带的值 |
sig | String | 必选 | md5加密,加密格式为sig= MD5(sid + fileid + token)不区分大小写 |
GET示例
GET示例
参数为: sid:12345678901234567890abcdefghijk0 token:abcdefghijklmnopkrstuvwxyz123456 fileid:1452133430935205 date:20160107 转换后: http://www.ucpaas.com/fileserver/record/12345678901234567890abcdefghijk0_1452133430935205_20160107?sig=b44531e6774ac9c505ddb600a5870ea5
属性 | 类型 | 约束 | 说明 | ||
---|---|---|---|---|---|
resp | respCode | String | 必选 | 参见 响应码说明 | |
respMsg | String | 必选 | 响应消息说明 | ||
fileId | fileId | String | 可选 | 生成的语音ID号,云之讯语音文件标识,开发者可忽略 |
JSON响应示例
JSON响应示例
{ "resp": { "respCode": "000000", "respMsg": "成功", "fileId": { "fileId": "2046" } } }
功能 | 上传所要播放的语音文件 |
---|---|
URL | http://www.ucpaas.com/maap/ipcc/voice/uploadFile |
Method | POST |
Headers | 简单的POST HEAD头域请求, 其中ContentType需要设置为multipart/form-data |
Body | 上传语音文件参数 |
Response | 一般响应对象 |
功能 | 下载留言文件或者录音文件 |
---|---|
URL | http://www.ucpaas.com/fileserver/record/ {sid}_{fileid}_{date}?sig={sig} |
Method | GET |
Headers | 简单的HTTP Get请求头 |
Parameter | 下载语音文件参数 |
Response | 文件的二进制流 |