获取录音地址
更新时间:2024-04-26
概述
调用接口,可获取通话录音地址
请求URL
https://aiob-open.baidu.com/api/v1/record
https://aicc.bce.baidu.com/api/v1/record(即将下架)
HTTP Method
POST、PUT、GET(建议按get方式接入,对于已经接入的老用户会做逻辑兼容,不影响使用)
POST和PUT从请求body中提取数据,GET从请求query string中提取数据
请求参数
Header
参数名称 | 是否必须 | 说明 | 示例 |
---|---|---|---|
Content-Type | POST或PUT时必须 | 请求类型 | application/json |
Authorization | 是 | 参考「生成认证Token」文档 | cc-api-auth-v1/5b050c050f5a4e74b8c20bf512e39c1d/2021-04-13T08:05:43Z/1800000/host;x-bce-date/746ed9ad706c379f31bafc292e3c720797e39bb7f08ce5f641d657e14e42dd33 |
Body(POST或PUT)
参数名称 | 类型 | 是否必须 | 说明 |
---|---|---|---|
contactUuid | String | 是 | 通话录音唯一标识 |
expiration | Int | 否 | 录音地址的超时时间,单位为秒,默认为1800秒,最大不超过3600秒 |
operation | Int | 否 | 录音地址类型,1为获取试听地址,2为获取下载地址,3为同时获取,默认为1 |
Query String(GET)
字段与Body一致
响应参数
参数名称 | 类型 | 说明 |
---|---|---|
requestId | String | 服务端为该次请求生成的唯一标识 |
code | Int | http响应码,比如200、400 |
msg | String | 响应信息,成功为success,失败时为具体原因 |
data | Array | 成功时为录音地址列表,失败时为空 |
data数据
参数名称 | 类型 | 说明 |
---|---|---|
recordUrl | String | 录音文件试听URL |
downloadUrl | String | 录音文件下载URL |
请求示例
GET请求示例
https://aiob-open.baidu.com/api/v1/record?contactUuid=1630760934746164_700189&operation=3&t=1630764534702_274573
POST/PUT请求示例
{
"contactUuid": "1630760934746164_700189",
"expiration": 1800,
"operation": 3
}
响应示例
{
"code": 200,
"msg": "success",
"data": [
{
"recordUrl": "http://xxx.baidubce.com/xxx.wav?",
"downloadUrl": "http://xxx.baidubce.com/xxx.wav"
}
]
}