本文档 API 接口为最新版本接口,后续相关功能的新增都会在此更新,推荐使用最新版本接口。旧版接口文档请参考历史版本。

你可以使用 ListDetectionTask 接口,查询指定用户的审核状态。

使用说明
接口行为

你可以使用 ListDetectionTask 接口,查询房间内指定用户通过 RTC 发送的音视频内容是否正处于审核中。

请求说明
请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query
参数类型是否必选示例值描述
ActionString是ListDetectionTask接口名称。当前 API 的名称为 ListDetectionTask。
VersionString是2023-11-01接口版本。当前 API 的版本为 2023-11-01。
AppIdString是Your_AppId应用的唯一标志
RoomIdString是Your_RoomId房间 ID,是房间的唯一标志
UserIdString否Your_UserId用户 ID
返回参数

下表仅列出本接口特有的返回参数,公共返回参数请参见返回结构。

参数类型示例值描述
EventDataObject of EventData-任务状态信息。如果从未对指定的用户发起审核,查询其审核状态时,返回的 EventData 值为空列表。
MessageStringsuccess仅在请求成功时返回success。
EventData
参数类型示例值描述
CreateTimeInteger1629183877用户审核发起时间戳,unix 时间,单位为秒。

MediaType

Integer

1

进行审核的内容类型:
1:视频截图;
2:音频切片;
3:视频截图+音频切片(默认值)

Status

Integer

1

审核状态:
1:运行中:
2:已完成;

请求示例
GET https://rtc.volcengineapi.com?Action=ListDetectionTask&Version=2023-11-01&AppId=Your_AppId&RoomId=Your_RoomId&UserId=Your_UserId
json
返回示例
{
    "ResponseMetadata": {
        "RequestId": "Your_RequestId",
        "Action": "ListDetectionTask",
        "Version": "2023-11-01",
        "Service": "rtc",
        "Region": "cn-north-1"
    },
    "Result":{
        "Message": "success",
        "EventData" : [{
                "CreateTime": 1629183877,
                "MediaType": 3,
                "Status": 2
        }, {
                "CreateTime": 1629271974,
                "MediaType": 3,
                "Status": 1
        }]
    }
}
json
错误码

您可访问公共错误码,获取更多错误码信息。