You need to enable JavaScript to run this app.
企业直播

企业直播

请输入
  • 文档首页
    • 企业直播直播质检API 参考APIListLiveScreenshot - 获取质检任务截图
复制全文
我的收藏
API
ListLiveScreenshot - 获取质检任务截图
复制全文
我的收藏
ListLiveScreenshot - 获取质检任务截图

调用 ListLiveScreenshot 接口，获取质检任务中的所有截图列表。

注意事项

仅支持获取 30 天以内创建的质检任务的截图数据。

请求说明

  • 请求方式：GET
  • 请求地址：https://livesaas.volcengineapi.com/?Action=ListLiveScreenshot&Version=2024-08-01

请求参数

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

Query

参数类型是否必选示例值描述
ActionString是ListLiveScreenshot接口名称。当前 API 的名称为 ListLiveScreenshot。
VersionString是2024-08-01接口版本。当前 API 的版本为 2024-08-01。
ProjectNameString是182701****608457项目名称。您可通过调用 ListProjects 接口获取 ProjectName。
TaskIdLong是39737671质检任务 ID。您可通过 ListTasks 获取 TaskId。仅支持传入近 30 天内创建的任务。
StartTimeLong否1744016864查询的开始时间。Unix 时间戳，单位为秒。若不传，则表示从直播开始时间查询。
EndTimeLong否1744016870查询的结束时间。Unix 时间戳，单位为秒。若不传，则表示查询至直播结束时间。
PageNumberInteger否1分页查询页码。取值范围为 [1,1000]，默认值为 1。
PageSizeInteger否10分页查询数量。取值范围为 [1,100]，默认值为 10。

返回参数

参数类型示例值描述
DataArray of Data-截图信息。
PageNumberInteger1分页查询页码。
PageSizeInteger10分页查询数量。
TotalCountInteger15查询结果总数。
TaskIdLong39737671质检任务 ID。

ActivityId

Long

1778****4933

质检任务关联的企业直播直播间 ID。
仅在满足以下任一条件时，该参数为直播间 ID，否则取值为 0。

  • 创建质检任务时关联了直播间 ID
  • 联系直播质检技术支持绑定企业直播账号后，主播通过企业直播开播，直播质检平台自动创建质检任务

Data

参数类型示例值描述
UrlStringhttp://image.com/screenshot.jpg截图的 URL 地址。有效期为 7 天，请尽快下载保存。
ScreenshotTimeLong60相对于直播开始时间的截图时间。单位为秒。例如：直播于 10:00:00 开始，若截图时间为 10:01:00，则参数取值为 60。
AbsoluteTimeLong1767842797截图的绝对时间。Unix 时间戳，单位为秒。

请求示例 

GET https://livesaas.volcengineapi.com/?Action=ListLiveScreenshot&Version=2024-08-01&ProjectName=182701****608457&TaskId=39737671&StartTime=30&EndTime=70&PageNumber=1&PageSize=10

返回示例 

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",        "Action": "ListLiveScreenshot",
        "Version": "2024-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1"
    },
    "Result": {
        "Data": [
            {
                "Url": "http://image.com/screenshot.jpg",
                "ScreenshotTime": 60,
                "AbsoluteTime": 1767842797
            }
        ],
        "PageNumber": 1,
        "PageSize": 10,
        "TotalCount": 15,
        "ActivityId": 1778****4933,
        "TaskId": 39737671
    }
}

错误码

访问公共错误码和错误码获取详细信息。

最近更新时间：2026.01.21 11:34:19
这个页面对您有帮助吗？
有用
有用
无用
无用