查询直播间关联视频列表

更新时间：2022-12-28

接口描述

查询某直播间下已关联的媒体

请求地址

https://ccapi.csslcloud.net/api/v1/video/onrelated

请求方式

GET

请求参数

接口统一权限认证请参考THQS认证方式。

名称 类型 必填 描述
account_id String 是 开发者账号ID
room_id String 是 直播间ID
video_id String 否 视频ID，支持批量，使用丨分隔，例如："0A0833E541533352丨0A0833E541533352"，取值范围：最大支持100个
page Integer 否 第几页，默认1。取值范围:大于1的整数
lines Integer 否 每页记录条数，默认50。取值范围:1~500整数
sort String 否 排序方式，取值说明："CREATION_DATE:ASC"为日期升序，"CREATION_DATE:DESC"为日期降序，"FILE_SIZE:ASC"为大小升序， "FILE_SIZE:DESC"为大小降序，"VIDEO_TITLE:ASC"为标题升序，"VIDEO_TITLE:DESC"为标题降序，默认"默认CREATION_DATE:ASC"
status String 否 视频状态，支持多选，以,分割，取值说明：正常为0，处理中为2或者10，标记删除为6，转码失败为7，彻底删除为11，取值范围[0,2,,6,7,10,11]
isvaild Integer 否 审核状态，取值说明：1为已审核 0为未审核，取值范围：[0,1]
categoryid String 否 视频分类ID
start_time String 否 创建时间，格式:yyyy-MM-dd HH:mm:ss，示例:"2022-12-11 00:00:00"
end_time String 否 结束时间，格式:yyyy-MM-dd HH:mm:ss，示例:"2022-12-11 00:00:00"
onlydata Integer 否 是否只查记录数据，取值说明：0为否，1为是，取值范围[0,1]
onlycount Integer 否 是否只查只查视频总数，取值说明：0为否，1为是，取值范围[0,1]
isactive Integer 否 只查询可用的视频(排除 标记删除/转码失败/删除)，取值说明：0为否，1为是，取值范围[0,1]

请求示例

GET https://ccapi.csslcloud.net/api/v1/video/onrelated?account_id=41E8063FC799ACE&room_id=D90DCF5BF6DA3C8C9C33DC5901307461&time=1670412086&hash={hash}

返回数据

名称 类型 描述
result String 返回状态：OK为成功，FAIL为失败
videos Array 视频列表，JSON Array

videos说明

名称 类型 描述
total Integer 视频总数
video Array 视频列表，JSON Array

video说明

名称 类型 描述
id String 视频ID
userid String 开发者账号ID
title String 视频标题
desp String 视频描述
tags String 视频标签
duration Integer 视频时长(s)
status Integer 视频状态：0为正常，2或者10为处理中，6为标记删除，7为转码失败，11为彻底删除
isvalid Integer 是否已经审核：0为未审核，1为已审核
filesize Integer 视频大小
type Integer 视频类型(清晰度大小)
creation-time String 创建时间，格式:yyyy-MM-dd HH:mm:ss，示例:"2022-12-11 00:00:00"
uploaduserid String 上传用户ID
category String 视频分类ID
hasvideofile Integer 视频文件是否存在：0为存在，1为删除
playurl String 播放地址
mediaType Integer 视频类型：1为视频，2为音频

返回示例

{
  "result": "OK", 
  "videos": {
    "total": 3, 
    "video": [
      {
        "id": "A4DE83629B02A0617E6C9CEE8B422289", 
        "userid": "1725A8A9604EAE30", 
        "title": "测试视频", 
        "desp": "这是第二条测试用的信息", 
        "tags": " ",  
        "duration": 30, 
        "status": 0, 
        "isvalid": 0, 
        "filesize": 489848, 
        "type": 80, 
        "creation-time": "2017-11-14 19:18:58", 
        "uploaduserid": "1725A8A9604EAE30",
        "category": "8395FBC2E22C76D2", 
        "hasvideofile": 0,
        "playurl": "", 
        "mediaType": 2  
      }

    ]
  }
}

results matching ""

    No results matching ""