3.5 比赛接口 · 电竞体育API对接文档

## **3.5 比赛接口** ### **1. 比赛列表** GET： ~~~ /api/match ~~~ 接口概述：获取比赛列表数据建议频率： * 每10分钟请求一次当前时间前后2小时之间的比赛 * 每20分钟请求一次当前时间之后2小时到8小时之间的未开始比赛 * 每30分钟请求一次当前时间之前2小时到37小时的已结束比赛 | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 是 | 页数 | | per_page | int | 是 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game_id | int | 否 | 游戏ID | | start_time | int | 否 | 比赛开始时间后的比赛 | | end_time | int | 否 | 比赛开始时间前的比赛 | 请求url示例 ~~~ /api/match?page=1&per_page=100&token=XXXXX ~~~ ### **2. 已结束比赛** GET： ~~~ /api/match/past ~~~ 接口概述：获取已结束比赛列表数据建议频率：查询时调用 | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 是 | 页数 | | per\_page | int | 是 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game\_id | int | 否 | 游戏ID | 请求url示例 ~~~ /api/match/past?page=1&per_page=100&token=XXXXX ~~~ ### **3. 正在进行比赛** GET： ~~~ /api/match/running ~~~ 接口概述：获取进行中比赛列表数据建议频率：查询时调用 | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 是 | 页数 | | per\_page | int | 是 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game\_id | int | 否 | 游戏ID | 请求url示例 ~~~ /api/match/running?page=1&per_page=100&token=XXXXX ~~~ ### **4. 未开始比赛** GET： ~~~ /api/match/upcoming ~~~ 接口概述：获取未开始比赛列表数据建议频率：查询时调用 | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 是 | 页数 | | per\_page | int | 是 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game\_id | int | 否 | 游戏ID | 请求url示例 ~~~ /api/match/upcoming?page=1&per_page=100&token=XXXXX ~~~ ### **5. 隐藏中比赛** GET： ~~~ /api/match/hidden ~~~ 接口概述：获取隐藏中的比赛列表数据建议频率：查询时调用 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 是 | 页数 | | per\_page | int | 是 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game\_id | int | 否 | 游戏ID | 请求url示例 ~~~ /api/match/hidden?page=1&per_page=100&token=XXXXX ~~~ ~~~ 比赛模块接口示例： { "id": 107, //比萨赛ID "bo": 3, //bo "status": 2, //比赛赛状态 "start_time": "2020-12-10 17:23:00", //开始时间 "end_time": "2020-12-10 21:08:00", //结束时间 "start_time_stamp": 1607592180, //开始时间 "end_time_stamp": 1607605680, //结束时间 "win_team": 277, //获胜队伍ID "odds_type": 55, //玩法类型（赛中玩法中、会开赛中玩法、赛前） "name_en": "PSG.LGD - VS - Elephant", //系列赛名称英文 "name_cn": "PSG.LGD - VS - Elephant", //系列赛名称中文 "game_id": 1, //游戏ID "series": { "id": 4, //赛事ID "name_en": "OGA Dota PIT China", //赛事英文名 "name_cn": "OGA Dota PIT - 中国", //赛事中文名 "logo": "xxxxxxxxx" //赛事logo }, "teams": [ { "team_id": 275, //战队ID "score": 0, //大比分 "index": 2, //左右边（1左边、2右边） "team": { "id": 275, //战队ID "name_cn": "Elephant", //战队中文名 "name_en": "Elephant", //战队英文名 "logo": "XXXXXXXXXXXX" //战队logo } }, { "team_id": 277, "score": 1, "index": 1, "team": { "id": 277, "name_cn": "PSG.LGD", "name_en": "PSG.LGD", "logo": "XXXXXXXXxx" } } ] } ~~~ | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | id | int | 比赛ID | | | bo| string |BO信息 | bo5指最多打5小局 | | status | int | 比赛状态 | 1未开始、2进行中、3已结束、-1隐藏状态、99取消）（状态为隐藏的比赛无可下盘，建议前端隐藏） | | start_time | string | 开始时间 | 格式2020-12-10 17:23:00| | end_time| string | 结束时间 | 格式2020-12-10 17:23:00| | start_time_stamp | int| 开始时间| 格式时间戳| | end_time_stamp| int | 结束时间 | 格式时间戳 | | win_team| int| 获胜队伍 | 值为队伍ID| | odds_type|int| 比赛玩法类型 | 55赛中玩法中、56会开赛中玩法、54只开赛前玩法| | name_cn|string| 队伍中文名 | | | name_en|string| 队伍英文名 | | | game_id|int| 所属游戏ID | 值为游戏ID| | series|object| 所属赛事信息 | [查看赛事接口](http://doc.antscore.io/2076675)| | team_id|int| 队伍ID | | | score|int| 队伍比分 |小局大比分 | | index|int| 队伍主客 | 1为左队主队，2为右队客队 | | team|object| 队伍信息 | [查看队伍接口](http://doc.antscore.io/2076676) |