## 3.6 比赛接口 ### 1.比赛列表 GET： ~~~ /api/v1/match ~~~ 接口概述：获取比赛列表数据 | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 否 | 页数 | | per_page | int | 否 | 每页数据条数 | | token | string | 是 | 客户密钥 | | game_id | int | 否 | 游戏ID | | series_id | int | 否 | 赛事ID | | league_id | int | 否 | 联赛ID | | status | string | 否 | 比赛状态：upcoming(未开始)， live(进行中) ，past(已结束)， cancel(已取消)，detele（已删除）| | start_time | int | 否 | 开始时间大于该时间 | | end_time | int | 否 | 结束时间小于该时间 | | day | int | 否 | 可以填写1-7，1代表24小时内变动数据筛选；7代表一周内变动数据筛选，2-6以此类推；若不填写或填写错误此参数不生效 | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /api/v1/match?page=1&per_page=100&token=XXXXX ~~~ ### 2.比赛详情 GET： ~~~ /api/v1/match/{match_id} ~~~ 接口概述：获取比赛详情数据 | 请求参数 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | token | string | 是 | 客户密钥 | | match_id | int | 否 | 比赛ID | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /api/v1/match/1?page=1&per_page=100&token=XXXXX ~~~ ~~~ { "id": 100121, //id "game_id": 3, //游戏id (1-lol,2-csgo,3-王者荣耀,4-dota2 ) "series": { "id": 1152, //id "name": "2021 KPL 秋季赛", //赛事名 "name_en": "", //英文名 "game_id": 3, //游戏id (1-lol,2-csgo,3-王者荣耀,4-dota2 ) "abbr": "KPL秋季赛", //简称 "logo": "https:xxxxx.png", "icon": "https:xxxxx.png", "status": "past", //赛事状态，参见字典 "start_time": 1632240000, //开始时间 "end_time": 1639843200 //结束时间 }, "stage": { "id": 1398, //阶段ID "name": "季军赛", //阶段名 "name_en": "季军赛", //阶段英文名 "mode": 0 //阶段英文名 }, "league": { //联赛信息 "id": 2044, //联赛id "name": "测试LOL新增联赛", //联赛名中文 "name_en": "YYY", //联赛名英文 "abbr": "测英雄", //简称 "logo": "https:xxxxx.png", "icon": "", "level": 999 //等级 }, "start_time": 1636286400, //开始时间 "end_time": 0, //结束时间 "teams": [ //队伍列表 { "team_id": 2534, //队伍id "score": 3, //比分 "index": 1, //队伍位置，参见字典 "win_rate": 0.52, //胜率 "team_info": { "id": 2534, //队伍id "name": "深圳DYG", //队伍名 "name_en":"", //队伍名英文 "abbr": "", //简称 "logo": "https:xxxxxx.png", "icon": "https:xxxxxx.png" } } ], "win_team": 2534, //获胜队伍 "has_rate": 1, //是否有胜率(-1(未知)/1(有)/2(无)) "is_pro": -1, //是否有pro 数据（-1:没有1:可能有 2;确定有） "has_push": -1, //是否已经推送, -1(没有) 1(有) "status": "past", //比赛状态，参见字典 "bo": 5, //bo信息 "menu":0 //是否有视频直播/动画直播/实时 "live_urls": [ //直播源列表 { "id": 2170, //id "url_type": "m3u8", //url字段直播地址的格式（flv或者m3u8） "url": "https://hlstct.xxxxx.cn.m3u8?", //（此地址不会为空，格式flv或者m3u8） "url2": "https://hlstct.xxxxx.c、.flv?", //（此地址只会给flv，可能为空） "language": "zh_CN", //直播语言（中文-zh_CN，越南语-vi_VN，韩语/朝鲜语-ko_KR,日语-ja_JP,英语-en_GB，葡萄牙语-pt_PT，葡萄牙语（巴西）-pt_BR，中国香港(粤语))-zh_HK，为空代表其他 "weight": 5, //直播链接优先级（数据越小，优先级越高） "is_deleted": false //是否删除（false否/ture 是） "is_pro": 1 //是否快直播，1：是，2否 } ] "update_time": 1693850106 //更新时间 } ~~~ | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | abbr | string | 简称 | \--- | | bo | int | bo信息 | \--- | | end\_time | int | 结束时间 | \--- | | game\_id | string | 游戏id (1-lol,2-csgo,3-王者荣耀,4-dota2 ) | \--- | | has\_push | int | 是否已经推送, -1(没有) 1(有) | \--- | | has\_rate | int | 是否有胜率(-1(未知)/1(有)/2(无)) | \--- | | icon | string | icon | \--- | | id | int | id | \--- | | image | string | \--- | \--- | | index | string | 队伍位置，参见字典 | \--- | | is\_deleted | string | \--- | \--- | | is\_pro | int | 是否有pro 数据（-1:没有1:可能有 2;确定有） | \--- | | logo | string | logo | \--- | | name | string | 游戏名/ 联赛名/ 赛事名/比赛名/ 队伍名/ 选手名/地区名 | 默认返回中文名。请求参数language: 1.不填 ,返中文；2.填vi, 返越南文；3.填zh_tw, 返繁体 | | name\_en | string | 赛事英文名/ 队伍英文名 | \--- | | platform | string | 来源平台 | \--- | | score | int | 比分 | \--- | | start\_time | int | 开始时间 | \--- | | status | string | 比赛状态/ 赛事状态，参见字典 | \--- | | team\_id | int | 队伍id | \--- | | time | string | \--- | \--- | | url | string | \--- | \--- | | weight | string | \--- | 直播链接优先级（数值越小，优先级越高） | | win\_rate | int | 胜率 | \--- | | win\_team | int | 获胜队伍 | \--- | |menu | int | 是否有视频直播/动画直播 | menu=0 无视频 无动画 无实时；menu=1有视频 无动画 无实时；menu=2无视频 有动画 无实时；menu=3有视频 有动画 无实时；menu=16 无视频 无动画 有实时；menu=17 有视频 无动画 有实时；menu=18 无视频 有动画 有实时；menu=19 有视频 有动画 有实时 | |stage | int | 比赛对应的阶段信息 |