======语音文件====== 语音文件包含上传和下载。 上传的语音文件是用于呼叫中心的各种语音播放，比如呼入彩铃，转坐席的保持音以及入队等待音。 该语音文件可以通过两种方式上传：\\ 1、通过开发者账户管理页面的ivr语音文件上传页面上传。\\ 2、通过语音文件上传接口上传。\\
语音文件上传后，需要通过审核才能够正式使用。
下载的语音文件主要是在通话过程中产生的录音文件，或者是用户留言的语音文件。 该节包含以下接口： * [[#上传语音文件接口| 上传语音文件接口]] * [[#下载语音文件接口| 下载语音文件接口]] ====上传语音文件参数 ====
上传语音文件需要通过multipart/form-data的形式提交
{| style="width:90%;" ! style="width:4em;"|属性 ! style="text-align:center;width:10em;"|类型 !style="text-align:center;width:8em;"|约束 ! |说明 |- |sid |String |style="text-align:center;"|必选 |主账户id，ucpaas平台生成，固定32位长度，可在开发者控制台查询 |- |appId |String |style="text-align:center;"|必选 |应用唯一标识 |- |token |String |style="text-align:center;"|必选 |主账号授权令牌token，可在开发者控制台查询 |- |time |String |style="text-align:center;"|必选 |时间戳，当前系统时间（ 24小时制），格式：yyyyMMddHHmmssSSS |- |sign |String |style="text-align:center;"|必选 |验证信息，使用MD5加密（主账户id+时间戳+账户授权令牌），共32位（小写） |- |file |multipart/form-data |style="text-align:center;"|必选 |语音文件，以**文件流**的形式上传，格式：MP3、wav，不能超过5MB，文件名字不能为中文，仅支持ascii码字符文件名 |} ---- 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-- ====下载语音文件参数 ==== {| style="width:90%;" ! style="width:4em;"|属性 ! style="text-align:center;width:8em;"|类型 !style="text-align:center;width:8em;"|约束 ! |说明 |- |sid |String |style="text-align:center;"|必选 |主账户id，ucpaas平台生成，固定32位长度，可在开发者控制台查询 |- |token |String |style="text-align:center;"|必选 |主账号授权令牌token，可在开发者控制台查询 |- |fileid |string |style="text-align:center;"|必选 |通话结束时返回的fileidName字段携带的值 |- |date |string |style="text-align:center;"|必选 |通话结束时返回的date字段携带的值 |- |sig |String |style="text-align:center;"|必选 |md5加密，加密格式为sig= MD5（sid + fileid + token）不区分大小写 |} ---- 参数为: sid:12345678901234567890abcdefghijk0 token:abcdefghijklmnopkrstuvwxyz123456 fileid:1452133430935205 date:20160107 转换后: http://www.ucpaas.com/fileserver/record/12345678901234567890abcdefghijk0_1452133430935205_20160107?sig=b44531e6774ac9c505ddb600a5870ea5 ==== 一般响应对象 ==== {| style="width:90%;" ! colspan="3" | 属性 ! 类型 !style="text-align:center;width:3em;"|约束 ! 说明 |- | rowspan="3" style="vertical-align: middle;"| resp | colspan="2" |respCode | String |style="text-align:center;"|必选 |参见[[:呼叫中心:errorcode_ipcc| 响应码说明]] |- | colspan="2" |respMsg | String |style="text-align:center;"|必选 |响应消息说明 |- |fileId |fileId |String |style="text-align:center;"|可选 |生成的语音ID号，云之讯语音文件标识，开发者可忽略 |} ---- { "resp": { "respCode": "000000", "respMsg": "成功", "fileId": { "fileId": "2046" } } } ---- ==== 上传语音文件接口 ==== {| style="width:90%;" !功能 |上传所要播放的语音文件 |- ! | URL | %%http://www.ucpaas.com/maap/ipcc/voice/uploadFile%% |- ! |Method | POST |- ! |Headers | 简单的POST HEAD头域请求, 其中ContentType需要设置为multipart/form-data |- ! Body | [[# 上传语音文件参数 | 上传语音文件参数]] |- ! Response | [[#一般响应对象| 一般响应对象]] |} ==== 下载语音文件接口 ==== {| style="width:90%;" !功能 |下载留言文件或者录音文件 |- ! | URL | %%http://www.ucpaas.com/fileserver/record/ {sid}_{fileid}_{date}?sig={sig}%% |- ! |Method | GET |- ! |Headers | 简单的HTTP Get请求头 |- ! Parameter | [[# 下载语音文件参数 | 下载语音文件参数]] |- ! Response | 文件的二进制流 |}