## 3.5 联赛接口 ### 1. 联赛列表 GET： ~~~ /sport/api/v1/leagues ~~~ 接口概述：获取所有联赛列表数据 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | 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，返繁体| ~~~ /sport/api/v1/leagues?sport_id=201&page=1&per_page=100&token=XXXXX ~~~ 返回示例 ```json { "code":0, "data":{ "list":[ { "id":3, //联赛id "region_id":0, //地区id "name":"中国男子篮球联赛", //联赛中文名 "abbr":"CBA", //简称 "abbr_en":"CBA", //简称 "name_en":"", //联赛英文名 "level": 3, //联赛等级 "logo":"xxxxx.png", //联赛logo "icon":"xxxxx.png", //联赛icon "alias":[ //别名 "CBA" ], "sport_id": 201, //运动id "status": "normal", //状态 "has_push": -1 , //是否有推送 "has_live": -1, //是否有直播 "update_time": 1657017536 //更新时间 "type": 1, //联赛类型：0-未知，1-联赛，2-杯赛，3-友谊赛 }, ... ], "total":6 }, "msg":"" } ``` ### 2.联赛详情 GET： ~~~ /sport/api/v1/leagues/{leagues_id} ~~~ 接口概述：获取所有联赛详情 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | int | 否 | 页数 | | per_page | int | 否 | 每页数据条数 | | token | string | 是 | 客户密钥 | | league_id | int | 否 | 联赛ID | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /sport/api/v1/leagues/1?page=1&per_page=100&token=XXXXX ~~~ 返回格式示例： ```json { "id": 1, "region_id": 11, "name": "美国男子职业篮球联赛", //联赛名 "abbr": "NBA", //联赛简称 "name_en": " ", //联赛英文名 "level": 99, //联赛等级 "logo": "https://example.png", //联赛logo "icon": "https://example.png", //联赛icon "alias": [ //别名 "NBA" ], "sport_id": 201, //运动ID "status": "", //联赛状态 "has_push":-1 , //是否有推送 "has_live": -1, //是否有直播 "series_ids": [ //该联赛关联的赛事id（非热门联赛无关联数据则不显示该字段） 9, 8818, 8713, 13, 10, 2, 16, 3, 18, 14, 6, 15, 17, 1, 7, 11, 4, 12, 5, 8 ], "type": 1, //联赛类型：0-未知，1-联赛，2-杯赛，3-友谊赛 "title_holder": [ //卫冕冠军 备注：无具体数据会隐藏该字段 24545, //球队id 1 //赛事冠军次数 ], "most_titles": [ //夺冠最多球队 备注：无具体数据会隐藏该字段 24082, //球队id 3 //赛事冠军次数 ], "low_newcomers": [ //晋级淘汰球队【低级赛事升级球队】 备注：无具体数据会隐藏该字段 24082, //球队id 2308, //球队id ], "high_newcomers": [ //晋级淘汰球队【高级赛事升级球队】 备注：无具体数据会隐藏该字段 24082, //球队id 2308, //球队id ], "low_divisions": [ //赛事层级【低一级赛事id】 备注：无具体数据会隐藏该字段 24082, //球队id 2308, //球队id ], "high_divisions": [ //赛事层级【高一级赛事id】 备注：无具体数据会隐藏该字段 24082, //球队id 2308, //球队id ], "host_country": England, //举办国家 "host_city": England, //举办城市 "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":" " //印度语 }, "region": { //地区 "id": 173, //地区id "pid": 0, //所属地区id（层级关系） "name": "美国", //地区名 "abbr": "美国", //简称 "name_en": "United States", //地区英文名 "logo": "xxxxx.png", //地区LOGO "icon": "xxxxx.png", //地区ICON "alias": [ //地区别名（可能会存在多个别名） "美国", "United States", "美國" ], "sport_id": 201 } ``` | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | id | int | 联赛ID | | | name | string | 联赛名 | | | name_en | string | 联赛英文名 | | | sport_id | int |所属运动ID | | | logo | string | 联赛logo | 部分可能没有 | | lang | string | 多语言数据（联赛名）|