滑雪集锦接口
更新时间：2024-06-05
查询滑雪剪辑
接口描述
本接口用于查询该滑雪赛事的滑雪剪辑视频
请求
请求路径
| 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" }