查询语音检测结果

最近更新时间:2019-08-28 13:42:13

1. 接口描述

接口请求域名: gme.tencentcloudapi.com 。

本接口(DescribeScanResultList)用于查询语音检测结果,查询任务列表最多支持100个。

如果在提交语音检测任务时未设置 Callback 字段,则需要通过本接口获取检测结果

默认接口请求频率限制:20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeScanResultList
Version String 公共参数,本接口取值:2018-07-11
Region String 公共参数,本接口不需要传递此参数。
BizId Integer 应用 ID,在控制台统一创建。
TaskIdList.N Array of String 查询的任务 ID 列表,任务 ID 列表最多支持 100 个。

3. 输出参数

参数名称 类型 描述
Data Array of DescribeScanResult 要查询的语音检测任务的结果
注意:此字段可能返回 null,表示取不到有效值。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询语音检测结果

输入示例

https://gme.tencentcloudapi.com/?Action=DescribeScanResultList
&BizId=1400000000
&TaskIdList.0=xxx
&<公共请求参数>

输出示例

{
  "Data": [
    {
      "Code": 0,
      "DataId": "1400000000_test_data_id",
      "ScanFinishTime": 1566720906,
      "HitFlag": true,
      "Live": false,
      "Msg": "",
      "ScanPiece": [
        {
          "DumpUrl": "",
          "HitFlag": true,
          "MainType": "abuse",
          "ScanDetail": [
            {
              "EndTime": 1110,
              "KeyWord": "xxx",
              "Label": "abuse",
              "Rate": "90.00",
              "StartTime": 1110
            },
            {
              "EndTime": 1380,
              "KeyWord": "xxx",
              "Label": "abuse",
              "Rate": "90.00",
              "StartTime": 930
            },
            {
              "EndTime": 1560,
              "KeyWord": "xxx",
              "Label": "abuse",
              "Rate": "90.00",
              "StartTime": 930
            },
            {
              "EndTime": 2820,
              "KeyWord": "xxx",
              "Label": "abuse",
              "Rate": "90.00",
              "StartTime": 2490
            }
          ]
        }
      ],
      "ScanStartTime": 1566720905,
      "Scenes": [
        "default"
      ],
      "Status": "Success",
      "TaskId": "xxx",
      "Url": "https://xxx/xxx.m4a"
    }
  ],
  "RequestId": "xxx"
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
InternalError 内部错误
InvalidParameter 参数错误
InvalidParameter.TagKey 标签不合法。
MissingParameter. 缺少参数
ResourceNotFound 资源不存在
UnauthorizedOperation 未授权操作。
UnknownParameter 未知参数错误。
UnsupportedOperation 操作不支持