QueryRecordFileDownloadUrl_号码隐私保护服务_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 如果在绑定关系中开启了录音功能,该绑定关系产生的所有通话均会被录音,可以通过此接口获取录音文件的下载链接,下载录音文件。

  • 您可以使用此接口获取录音文件的下载链接进行录音文件下载,也可以在控制台呼叫记录查询页面查询呼叫记录,单击录音文件操作列的下载下拉项,单击录音音频进行录音文件下载。

  • 在使用此接口前,建议您先明确需要获取的录音文件对应的呼叫记录。 您可以在控制台呼叫记录查询页面进行查询,获取呼叫记录 ID、呼叫发起时间等信息,或者参考回执消息简介与配置流程,订阅回执消息类型录音状态报告(SecretRecording)的消息,该报告消息中的结果字段可以作为此接口的入参。

QPS 限制

本接口的单用户 QPS 限制为 3000 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。

PoolKey 和 ProductType 限制

PoolKey 和 ProductType 参数请至少填写一个,若两个参数都不填,调用接口时会报错。建议原阿里大于用户填 ProductType 参数,阿里云用户填 PoolKey 参数。

获取录音文件步骤:

  1. 在更新或绑定关系接口中选择入参需要录音。
  2. 在控制台中订阅录音消息回执。
  3. 录音消息回执返回后调用 QueryRecordFileDownloadUrl 接口下载录音。
说明
  • URL 链接的有效期为 2 小时。获取下载链接后请尽快下载录音文件。
  • 录音文件的存储周期是 30 天,仅支持下载 30 天内通话记录的录音文件。
  • 流控信息

    请求速率为3000/1(s)。更多流控信息,请前往配额中心查看

    授权信息

    如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

    具体说明如下:展开详情

    操作访问级别资源类型条件关键字关联操作
    dypls:QueryRecordFileDownloadUrl
    Get
    全部资源
    *

    请求参数

    字段名称字段详情
    PoolKeystring

    号码池 Key。展开详情

    示例值:FC10000012345****
    ProductTypestring

    产品类型。取值:展开详情

    示例值:AXB_170
    CallIdstring

    呼叫记录 ID,用于标识一条通话记录。展开详情

    示例值:416*********bd50
    CallTimestring

    呼叫记录中的呼叫发起时间。展开详情

    示例值:2019-03-05 12:00:00

    返回参数

    字段名称字段详情
    Codestring

    请求状态码。展开详情

    示例值:OK
    Messagestring

    状态码的描述。

    示例值:OK
    RequestIdstring

    请求 ID。

    示例值:1AB3CEF7-DCBE-488C-9C33-D180982CE031
    DownloadUrlstring

    录音文件的下载链接 URL。URL 链接的有效期为 2 小时。

    示例值:http://secret-axb-reco****cn-shanghai.aliyuncs.com/1000000820******_66647243838006067251************.mp3?Expires=1551******&OSSAccessKeyId=yourAccessKeyID&Signature=tK6Yq9KusU4n********7lg4/WmEA%3D

    返回示例

    变更历史

    暂无变更历史

    相关示例

    如果在绑定关系中开启了录音功能,该绑定关系产生的所有通话均会被录音
    2021-12-21