更新赛事
更新时间:2024-05-15
接口说明
本接口用来更新赛事的信息。
备注:
(1)增量修改,只会更新传入的参数;主设备deviceId不支持修改。
(2)赛事开始前,仅支持修改赛事时间、赛事名称、赛事描述、回调地址、转推地址、贴片信息、增加多机位。
(3)赛事进行中,仅支持修改赛事名称、赛事描述、回调地址、转推地址、贴片信息、增加多机位。
(4)赛事结束后,字段都不支持修改。
(5)赛事需要在创建时预先指定贴片模板ID,否则更新赛事贴片,无预先指定模板ID,贴片将不生效。
(6)赛事进行中,修改贴片会立即生效。添加未使用槽位的贴片会触发更新,添加已使用槽位的贴片会触发增加。
(7)赛事进行中, 可修改结束时间提前结束比赛或者延长赛事时间。
(8)多机位时,部分从设备处理错误不会影响方法报错,处理错误信息会通过secondaryDevicesErrInfoList返回。
请求
请求路径
Path | Method | 说明 |
---|---|---|
/v1/event/{id} | PUT | 更新赛事信息 |
请求参数
无
请求头
无其他特殊头域
请求体
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
name | String | 赛事name | N |
sportType | String | 赛事类型 | N |
description | String | 赛事描述 | N |
startTime | Long | 赛事开始时间,秒级时间戳 | N |
endTime | Long | 赛事结束时间,秒级时间戳 | N |
media | Object | 媒体信息 | N |
callbackUrl | String | 事件回调url | N |
graphics | Object | 贴片配置 | N |
+patternId | String | 贴片样式模板id | N |
+team | Object | 队伍信息 | N |
+scoreboard | List | 比分板 | N |
+clock | List | 计时器 | N |
+text | List | 文本配置 | N |
+image | List | 图片水印配置 | N |
响应
响应头域
除公共头域外,无其他特殊头域
响应体
参数 | 类型 | 描述 | 备注 |
---|---|---|---|
Event | Object | 赛事信息 | |
+id | String | 赛事ID | |
+ .... | ..... | 详见Event实体信息 | |
errorMessage | String | 错误信息 | |
secondaryDevicesErrInfoList | List | 多机位错误信息 | 存在多机位时,且处理错误时返回 |
+deviceId | String | 多机位设备ID | |
+errorMessage | string | 该设备处理中产生的报错信息 |
示例
-
请求示例
Text1PUT /v1/event/event-aaaaaa1 HTTP/1.1 2host: {host} 3content-type: application/json 4authorization: {authorization} 5 6{ 7 "name":"修改后的赛事名称", 8 "graphics":{ 9 "image":[ 10 { 11 "index":2, 12 "imageUrl":"http://xxx.2_new.jpg" 13 } 14 ] 15 } 16} 17// 该请求修改了赛事名称和index=2图片槽位的图片
-
响应示例
Text1HTTP/1.1 200 OK 2x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2 3Date: Tue, 08 Now 2023 15:00:00 GMT 4Content-Type: application/json;charset=UTF-8 5 6{ 7 8 "event": { 9 "id":"event-aaaaaa1", 10 "userId":"xxx", 11 "deviceId":"device-aaaaaa1", 12 "secondaryDeviceIDList":["device-thirdParty", "device_bbbb1"], 13 "name":"测试后的赛事名称", 14 "state":"notStarted", 15 "sportType":"volleyball", 16 "startTime":1667890800, 17 "endTime":1667898000, 18 "media":{ 19 "liveStream":[ 20 "1080p" 21 ], 22 "recording":[ 23 "1080p" 24 ], 25 "mediaState":"liveStreamUnready", 26 "forwardUrl":[ 27 "rtmp://xxxx/xxxx/xxxxxxxx" 28 ] 29 }, 30 "graphics":{ 31 "patternId":"pattern-1", 32 "team":{ 33 "homeTeam":{ 34 "name":"非凡排球", 35 "boxColor":"#FF0000" 36 }, 37 "awayTeam":{ 38 "name":"沙排联盟", 39 "boxColor":"#FFFF00" 40 } 41 }, 42 "scoreboard":[ 43 { 44 "index":1, 45 "homeTeamScore":2, 46 "awayTeamScore":4 47 }, 48 { 49 "index":2, 50 "homeTeamScore":5, 51 "awayTeamScore":10 52 } 53 ], 54 "text":[ 55 { 56 "index":1, 57 "content":"三亚沙滩排球\"甘伯杯\"2023年预选赛" 58 } 59 ], 60 "image":[ 61 { 62 "index":1, 63 "imageUrl":"http://xxx.1.jpg" 64 }, 65 { 66 "index":2, 67 "imageUrl":"http://xxx.2_new.jpg" 68 }, 69 { 70 "index":3, 71 "imageUrl":"http://xxx.3.jpg" 72 } 73 ] 74 } 75 } 76}