滑雪集锦接口

查询滑雪剪辑

接口描述

本接口用于查询该滑雪赛事的滑雪剪辑视频

请求

请求路径

Path	Method	说明
/v1/event/{$eventId}/ski_clips	GET	查询滑雪剪辑视频

请求参数

参数	类型	是否必须	描述
start	Integer	否	查询时间区间的开始时间，unix时间戳，如1707198000
end	Integer	否	查询时间区间的结束时间，unix时间戳，如1707200000
upperColor	String	否	上身衣服颜色
lowerColor	String	否	下身衣服颜色
pageSize	String	否	返回的一页数量大小（大于100则为默认值100）
marker	String	否	本次查询的起点

注意：时间区间为左闭右开

请求头

无其他特殊头域

请求体

无

响应头域

除公共头域外，无其他特殊头域

响应体

参数	类型	描述
maker	String	本次查询的起点(已经加密)
nextMarker	String	下一次查询的起点，为空表示已经返回所有结果(已经加密)
count	Integer	返回的列表中剪辑个数
data	List	剪辑列表
+eventId	String	赛事id
+stream	String	流名
+clipsId	String	剪辑id
+upperColor	String	上身衣服颜色
+lowerColor	String	下身衣服颜色
+duration	Integer	剪辑视频时间，单位为s
+video	String	剪辑的bos地址
+thumbnail	String	缩略图的bos地址
+createTime	Integer	剪辑时间
+likes	Integer	点赞数

示例

• 请求示例

  GET /v1/event/event-xxxxxxxxxx/ski_clips?start=1707198000&end=1707200000&marker=000000zO HTTP/1.1
  host: {host}
  content-type: application/json
  authorization: {authorization}

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
  Date: Tue, 08 Now 2023 15:00:00 GMT
  Content-Type: application/json;charset=UTF-8
  
  {
    "count": 5,
    "data": [
        {
            "eventId": "event-xxxxxxxxxx",
            "stream": "event-xxxxxxxxxx_2",
            "clipsId": "00001929-c65fabeb",
            "upperColor": "黑",
            "lowerColor": "黑",
            "duration": 7,
            "video": "https://ibs-xxxx.cdn.bcebos.com/ski/event-xxxxxxxxxx_2/2024_3_4/20/00001929-c65fabeb.mp4",
            "thumbnail": "https://ibs-xxxx.cdn.bcebos.com/ski/event-xxxxxxxxxx_2/2024_3_4/20/00001929-c65fabeb.jpg",
            "meta": "https://ibs-test.cdn.bcebos.com/ski/event-xxxxxxxxxx_2/2024_3_4/20/00001929-c65fabeb.json",
            "createTime": 1709556285
        },
        {
            "eventId": "event-5e255c5c7bfd",
            "stream": "event-5e255c5c7bfd_2",
            "clipsId": "00001951-811fadbc",
            "upperColor": "红",
            "lowerColor": "黑",
            "duration": 10,
            "video": "https://ibs-xxxx.cdn.bcebos.com/ski/event-xxxxxxxxxx_2/2024_3_4/20/00001951-811fadbc.mp4",
            "thumbnail": "https://ibs-xxxx.cdn.bcebos.com/ski/event-xxxxxxxxxx_2/2024_3_4/20/00001951-811fadbc.jpg",
            "meta": "https://ibs-xxxx.cdn.bcebos.com/ski/event-xxxxxxxxxx_2/2024_3_4/20/00001951-811fadbc.json",
            "createTime": 1709556468
        }
    ],
    "marker": "000000zO",
    "nextMarker": "00000199"
  }

滑雪剪辑点赞接口

接口描述

本接口用于增加或减少滑雪剪辑的点赞数。

请求

请求路径

Path	Method	说明
/v1/event/{$eventId}/ski_clips/like	PUT	增加/减少滑雪剪辑的点赞数

请求参数

参数	类型	是否必须	描述
clipsId	String	是	剪辑id
action	String	是	like为点赞；unlike为取消点赞

请求头

无其他特殊头域

请求体

无

响应头域

除公共头域外，无其他特殊头域

响应体

无

示例

• 请求示例

  PUT /v1/event/event-xxxxxxxxxx/ski_clips/like?clipsId=00001013-765765d5&action=like HTTP/1.1
  host: {host}
  content-type: application/json
  authorization: {authorization}

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
  Date: Tue, 08 Now 2023 15:00:00 GMT
  Content-Type: application/json;charset=UTF-8
  
  ok

滑雪集锦接口

接口描述

本接口用于将该滑雪赛事下多个剪辑视频合成一个集锦视频

请求

请求路径

Path	Method	说明
/v1/event/${eventId}/ski_highlights	POST	生成滑雪集锦视频

请求参数

无

请求头

无其他特殊头域

请求体

参数	类型	是否必须	描述
clipsIdList	List<String>	是	剪辑ID列表（限制：最多10个clips）
template	String	否	模板名字，不填时为默认模板

响应头域

除公共头域外，无其他特殊头域

响应体

参数	类型	描述
higlightId	String	集锦ID，一条集锦的唯一标识

示例

• 请求示例

  POST /v1/event/event-xxxxxxxxxx/ski_highlights HTTP/1.1
  host: {host}
  content-type: application/json
  authorization: {authorization}
  
  {
    "clipsIdList": [
        "15-00000083-d5892e60",
        "15-00000083-d5892e61"
    ],
     "template":"hig-xxxxxxxx"
  }

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
  Date: Tue, 08 Now 2023 15:00:00 GMT
  Content-Type: application/json;charset=UTF-8
  
  {
    "highlightId": "954498ff-9112-xxxx-bcca-6ceaafcf6216"
  }