##3.6 赛事接口 ### 1. 赛事列表 GET： ~~~ /sport/api/v1/series ~~~ 接口概述：获取所有赛事列表数据 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 否 | 页数 | | per\_page | int | 否 | 每页数据条数 | | token | string | 是 | 客户密钥 | | sport\_id | int | 是 | 运动ID | | day | int | 否 | 可以填写1-7，1代表24小时内变动数据筛选；7代表一周内变动数据筛选，2-6以此类推；若不填写或填写错误此参数不生效 | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /sport/api/v1/series?page=1&per_page=100&token=XXXXX ~~~ 返回格式示例： ~~~ { "code": 0, "data": { "list": [ { "region_id": 0, //地区ID "league_id": 2047, //联赛id "league_name": " ", //联赛名 "league_name_en": "Europe EBC U18A", //联赛英文名 "name": "中国贵州村超联赛", //赛事名 "name_en": "Rural Football Super League", //赛事英文名 "abbr": "村超", //赛事简称 "abbr_en": "Rural Football Super League", //赛事简称（英文） "id": 10260, //赛事id "season_name": "", //赛季名 "year": 2023, //赛事年份 "start_time": 1700197200, //开始时间 "end_time": 1700798400, //结束时间 "status": "", //状态 "level": 0, //赛事等级 "is_hot": 0, //是否热门（废弃） "has_push": -1, //是否有推送 "has_live": -1, //是否有直播 "sport_id": 201, //运动id "cover": "", //赛事封面 "update_time": 1690387264, //更新时间 "ordinary_mvp": 0, //常规赛MVP "finals_mvp": 0, //决赛FMVP "series_teams": [ //赛事下的队伍（不一定有） { "team_id": 3174, //队伍ID "rank": "1", //队伍排名 "team": { "id": 3174, //队伍ID "name": "丹佛掘金", //队伍名 "name_en": "Denver Nuggets", //队伍英文名 "abbr": "掘金", //队伍简称 "logo": "https://XXX.png", //队伍logo "icon": "https://XXX.png", //队伍icon "integral": 7 //废弃 } }, ........ ], "teams": [ //该赛事关联的队伍id 2079, 3073, 2921 ] }， ....... ~~~ ### **2.赛事详情** GET： ~~~ /sport/api/v1/series/{id} ~~~ 接口概述：获取所有赛事详情 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 否 | 页数 | | per\_page | int | 否 | 每页数据条数 | | token | string | 是 | 客户密钥 | | sport\_id | int | 是 | 运动ID | | series_id | int | 否 | 赛事ID | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /sport/api/v1/series/22998?page=1&per_page=100&token=XXXXX ~~~ 返回格式示例： ```json { "region_id": 0, //地区ID "league_id": 231, //联赛ID "league_name": "美洲女子篮球杯" //所属联赛名 "league_name_en": "Americas Women's Basketball Cup", //所属联赛英文名 "name": "美洲女子篮球杯", //赛事名 "name_en": "美洲女子篮球杯", //赛事英文名 "abbr": "xxx", //赛事简称 "abbr_en": "xxx", //赛事简称英文 "id": 2299, //赛事ID "season_name": "2012", //赛季名 "year": 2012, //赛季 "start_time": 0, //开始时间 "end_time": 0, //结束时间 "status": "", //赛事状态 "level": 99, //赛事等级 "is_hot": 2, //是否热门（1是，2否）（废弃） "has_push": , //是否有推送 "has_live": , //是否有直播 "sport_id": 202 //运动id（201篮球；202足球） "cover": "", //赛事封面 "ordinary_mvp": 0, //常规赛MVP "finals_mvp": 0, //决赛FMVP "series_teams": [ //赛事下的球队（不一定有） { "team_id": 3174, //球队ID "rank": "1", //球队排名 "team": { "id": 3174, //球队ID "name": "丹佛掘金", //球队名 "name_en": "Denver Nuggets", //球队英文名 "abbr": "掘金", //球队简称 "logo": "https://XXX.png", //球队logo "icon": "https://XXX.png", //球队icon "integral": 7 //废弃 } }, ........ ], "teams": [ //该赛事关联的球队id 3170, 3673, 3175, 3184, 3172, ], "lang":{ "name_zh_tw":" ", //繁体中文 "name_es":" ", //西班牙语 "name_pt":" ", //葡萄牙语 "name_fr":" ", //法语 "name_de":" ", //德语 "name_sv":" ", //瑞典语 "name_ru":" ", //俄语 "name_uk":" ", //乌克兰语 "name_da":" ", //丹麦语 "name_pl":" ", //波兰语 "name_nl":" ", //荷兰语 "name_ko":" ", //韩语 "name_ms":" ", //马来语 "name_tl":" ", //他加禄语 "name_vi":" ", //越南语 "name_el":" ", //希腊语 "name_tr":" ", //土耳其语 "name_thai":" ", //泰语 "name_ar":" " //阿拉伯语 "name_hi":" " //印度语 "name_ja":" " //日语 }, "stage_num": 12, //轮次 "player_num": 612, //队员数量 "team_num": 30, //队伍数量 "foreign_players": 0, //非本土 "market": null //市值 } ``` | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | id | int | 赛事ID |--- | | name | string | 赛事名 | --- | | name_en | string | 赛事英文名 |--- | | sport\_id | int | 所属运动ID |--- | | logo | string | 赛事logo | 部分可能没有 | | ordinary_mvp | int | 常规赛MVP | 备注：返回选手ID | | finals_mvp | int | 决赛FMVP | 备注：返回选手ID | | team_id | int | 球队ID |--- | | rank | string | 球队排名 |--- | | id | int | 球队ID | --- | | name | string | 球队全称 |--- | | name_en | string | 球队英文名 | --- | | abbr | string | 球队简称 |--- | | logo | string | 球队logo |--- | | icon | string | 球队icon | --- |