## **3.5 比赛接口** ### **1. 比赛列表** GET： ~~~ /api/v1/match ~~~ | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 是 | 页数 | | per\_page | int | 是 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game\_id | int | 否 | 运动ID | | start\_time | int | 否 | 比赛开始时间后的比赛 | | end\_time | int | 否 | 比赛开始时间前的比赛 | | status | int | 比赛状态 | 未知：UNKNOWN, 已结束：ENDED, 未开始： NOT\_STARTED, 进行中：LIVE, 取消： CANCELLED, 废弃:ABANDONED,暂停，关闭：CLOSED（等同已结束），已延期：DELAYED，暂停： SUSPENDED，隐藏：HIDDEN（状态为隐藏的比赛无可下盘，建议前端隐藏） | 请求url示例 ~~~ /api/v1/match?page=1&per_page=100&token=XXXXX ~~~ ~~~ 比赛模块接口示例： { "id": 1, "game_id": 2, "series_id": 2, "start_time": 0, "end_time": 0, "status": "NOT_STARTED", "bo": 1, "live_url": "", "group_type": 0, "team_ids": [ 1, 2 ], "win_team": 0, "series": { "id": 2, "game_id": 2, "name_cn": "", "name_en": "MLB. Season 2021", "abbr": "", "country": "US", "logo": "XXXXX", "start_time": 1617260400, "end_time": 0 }, "teams": [ { "id": 1, "match_id": 1, "team_id": 1, "index": 2, "total_score": "0", "scores": [], "team": { "id": 1, "game_id": 2, "name_cn": "", "name_en": "Boston Red Sox", "abbr": "", "logo": "XXXXX", "country": "" } }, { "id": 2, "match_id": 1, "team_id": 2, "index": 1, "total_score": "0", "scores": [], "team": { "id": 2, "game_id": 2, "name_cn": "", "name_en": "New York Yankees", "abbr": "", "logo": "XXXXX", "country": "" } } ] } ~~~ | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | id | int | 比赛ID | | | bo | string | BO信息 | bo5指最多打5小局 | | status | int | 比赛状态 | 未知：UNKNOWN, 已结束：ENDED，关闭:CLOESD, 未开始： NOT\_STARTED, 进行中：LIVE, 取消： CANCELLED, 暂停： SUSPENDED，隐藏：HIDDEN（状态为隐藏的比赛无可下盘，建议前端隐藏） | | start\_time | int | 开始时间 | 格式时间戳 | | end\_time | int | 结束时间 | 格式时间戳 | | win\_team | int | 获胜队伍 | 值为队伍ID | | group\_type | int | 比赛玩法类型 | 54不开滚球、55正在滚球、56会开滚球 | | name\_cn | string | 队伍中文名 | | | name\_en | string | 队伍英文名 | | | game\_id | int | 所属游戏ID | 值为游戏ID | | live\_url | string | 直播视频流 | 值为m3u8的视频流地址 | | series | object | 所属赛事信息 | | | team\_id | int | 队伍ID | | | score | int | 队伍比分 | 小局大比分 | | index | int | 队伍主客 | 1为左队主队，2为右队客队 | | team | object | 队伍信息 | | | id | int | 比赛ID | | | bo | string | BO信息 | bo5指最多打5小局 | | status | int | 比赛状态 | 未知：UNKNOWN, 已结束：ENDED, 未开始： NOT\_STARTED, 进行中：LIVE, 取消： CANCELLED, 废弃:ABANDONED,暂停，关闭：CLOSED（等同已结束），已延期：DELAYED，暂停： SUSPENDED，隐藏：HIDDEN（状态为隐藏的比赛无可下盘，建议前端隐藏） | | start\_time | int | 开始时间 | 格式时间戳 | | end\_time | int | 结束时间 | 格式时间戳 | | win\_team | int | 获胜队伍 | 值为队伍ID | | group\_type | int | 比赛玩法类型 | 54不开滚球、55正在滚球、56会开滚球 | | name\_cn | string | 队伍中文名 | | | name\_en | string | 队伍英文名 | | | game\_id | int | 所属运动ID | 值为运动ID | | live\_url | string | 直播视频流 | 值为m3u8的视频流地址 | | series | object | 所属赛事信息 | | | team\_id | int | 队伍ID | | | score | int | 队伍比分 | 小局大比分 | | index | int | 队伍主客 | 1为左队主队，2为右队客队 | | team | object | 队伍信息 ||