录音解冻接口文档

接口说明

录音时间超过两个月后，录音会进入冷冻状态。获取录音前需要先解冻，解冻时效为24小时，超过24小时需再次解冻。解冻过程大约需要2分钟，解冻成功后可直接访问原录音地址。

请求信息

请求方法: GET

请求路径: /api/v1/recordVoiceRestore.json

调用者权限: 所有客服

请求参数

Query 参数

名称	必填	类型	注释
`url`	是	varchar	录音地址，可通过获取通话记录详情接口获取
`restore`	是	int	固定值写 `1`

调用示例

返回参数

名称	类型	注释
`status`	String	解冻状态（详见下方状态对照表）
`message`	String	状态描述信息
`file_path`	String	录音文件地址（相对地址）
`file_name`	String	录音文件名称

状态对照表

状态值	说明
`RestoreAlreadyInProgress`	解冻中
`RestoreCompleted`	解冻完成
`OperationNotSupported`	不支持解冻
`NoSuchKey`	目标不存在
`RestoreFailed`	解冻失败
`RestoreTodo`	待解冻
`ExceptionStatus`	文件状态异常，请联系管理员
`CorrectStatus`	状态正常（无需解冻）

返回值示例

解冻成功/状态正常

{
    "status": "CorrectStatus",
    "message": "状态正常",
    "file_path": "/recordings/71f717e43078338c/7a0604948a6b615c/20230101/xxx.wav",
    "file_name": "xxx.wav"
}

通用说明

基础URL: https://www.bangwo8.com

数据格式: JSON

解冻时效: 24小时（超过需重新解冻）

解冻耗时: 约2分钟

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

示例

{
    "status": "CorrectStatus",
    "message": "状态正常",
    "file_path": "/recordings/71f717e43078338c/7a0604948a6b615c/20230101/xxx.wav",
    "file_name": "xxx.wav"
}

录音解冻

录音解冻接口文档#

接口说明#

请求信息#

请求参数#

Query 参数#

调用示例#

返回参数#

状态对照表#

返回值示例#

解冻成功/状态正常#

通用说明#

请求参数

请求示例代码

返回响应

录音解冻接口文档

接口说明

请求信息

请求参数

Query 参数

调用示例

返回参数

状态对照表

返回值示例

解冻成功/状态正常

通用说明