## **3.5 比赛列表接口** ### **1. 比赛列表** GET： ~~~ /api/v1/match ~~~ 接口概述：获取比赛赛程 建议频率：10分钟一次 | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 是 | 页数 | | per_page | int | 是 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game_id | int | 否 | 运动ID | | start_time | int | 否 | 比赛开始时间后的比赛 | | end_time | int | 否 | 比赛开始时间前的比赛 | | status | int |否|比赛状态： 1未开始、2进行中、3已结束、4延期、5中断、99取消 、-1隐藏|| 请求url示例 ~~~ /api/v1/match?page=1&per_page=100&token=XXXXX ~~~ ~~~ 比赛模块接口示例： { "code": 0, "data": { "list": [ { "id": 1, //比赛ID "game_id": 2, //游戏ID "start_time": 0, //比赛开始时间 "end_time": 0, //比赛结束时间 "status": "1", //比赛状态 "bo": 1, //bo "win_team": 0, //获胜队伍 ”live_status“：7 //实际状态,具体看一下文档3.8各个运动的live_status的注释 "m_type_n": "五局三胜", //比赛回合制（足篮球无此字段，仅针对小球） "series": { //赛事信息 "id": 2, "game_id": 2, //游戏ID "name_cn": "", "name_en": "MLB. Season 2021", "name_hi": " ", "abbr": "", "logo": ".png", "is_hot": ".1", //是否热门（0非热门，1热门） }, "teams": [ { "index": 1, //主客队（1主队、2客队） "total_score": "3", //总得分 "scores": [ { "stage": 1, //足球上下半场 篮球第几节 "score": "0" //得分 }, { "stage": 2, "score": "1" } ], "team": { "id": 22151, //队伍ID "game_id": 1, "name_cn": "拜仁慕尼黑", //队伍中文名 "name_en": "Bayern Munich", //队伍英文名 "name_hi": "बायर्न म्यूनिख", //队伍印度语 "logo": "XXXXX.png" } } ~~~ | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | id | int | 比赛ID | | | bo | string | BO信息 | bo5指最多打5小局 | | status | int | 比赛状态 | 1未开始、2进行中、3已结束、4延期、5中断、99取消、-1隐藏（比赛进行中，但是不开滚球的状态） || | start_time | int | 开始时间 | 格式时间戳 | | end_time | int | 结束时间 | 格式时间戳 | | win_team | int | 获胜队伍 | 值为队伍ID | | name_cn | string | 队伍中文名 | | | name_en | string | 队伍英文名 | | | name_hi | string | 队伍印度语 | | | game_id | int | 所属游戏ID | \ | | series | object | 所属赛事信息 | | | team_id | int | 队伍ID | | | score | int | 队伍比分 | 足球为上下半场比分；篮球为第一、第二、第三节、第四节比分 | | index | int | 队伍主客 | 1为左队主队，2为右队客队 | | team | object | 队伍信息 | |