3.3 球队接口 · 电竞体育API对接文档

## 3.3 球队接口 ### 1. 球队列表 GET： ~~~ /sport/api/v1/teams ~~~ 接口概述：获取所有球队数据 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | 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/teams?page=1&per_page=100&token=XXXXX ~~~ ***** ## 2.球队详情 GET： ~~~ /sport/api/v1/teams/{team_id} ~~~ 接口概述：获取球队详情数据建议频率：查询时调用 | 请求参数 | 数据类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | team_id | int | 否 | | | token | string | 是 | 客户密钥 | | language| string | 否 | 1.不填，“name”默认返中文；2. 填vi，字段“name” 返越南文；3.填zh_tw，返繁体| 请求url示例 ~~~ /sport/api/v1/teams/124846?token=XXXXX ~~~ 返回格式示例 ```json { "id": 32286, //球队ID "name": "湖人", //球队名 "name_en": "Lakers", //球队英文名 "abbr": "Lakers", //球队简称 "abbr_en": "Lakers", //球队名英文简称 "logo": "https://example.png",//球队logo "icon": "https://example.png",//球队icon players:{ //无数据则不返该字段 "id": 79455, //选手id "name": "埃林·布朗特·哈兰德", //选手中文名 "name_en": "Erling Braut Håland", //选手英文名 "team_id": 3138, //选手所在的队伍id "logo": "xxxx.png", //选手LOGO "position": "F", //选手位置（ F-前锋、M-中场、D-后卫、G-守门员、其他为未知） "number": 6, //选手球衣号码 "sport_id": 202, //运动id（201篮球；202足球） "status": "", //选手状态 "update_time": 0 //选手更新时间 }, ...... ] "sport_id": 201, //运动id "league_id":0, //联赛id "status": "normal", //球队状态 "integral": 0 //球队评分 "country": " " //所属国家 "league_name": "xx联赛", //所属联赛 "coach": "xxx", //主教练 "venue": "xx体育场", //场馆 "foundation_time": 1905, //球队成立时间 "website": "xxx", //球队官网 "national": 0, //是否是国家队 1-是，0-否 "country_logo": "xxx", //国家队logo，为国家队时存在 "market_value": 236580000, //市值 "market_value_currency": "", //市值单位 "total_players": 45, //总球员数 "foreign_players": 26, //非本土球员数备注：-1代表没有该字段数据 "national_players": 26, //国家队球员数备注：-1代表没有该字段数据 "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":" " //印度语 }, "players": [ //队伍下得选手信息 { "id": 1011082, //选手ID "name": "卡洛斯·莫拉莱斯", //选手名称 "name_en": "carlos morales", //选手英文名称 "league_id": 546, //选手所属联赛 "team_id": 13022, //选手所属的队伍ID "abbr": "", //选手简介 "logo": "https://img.xxx.png", //选手logo "half_logo": "", //选手半身照 "icon": "", //选手icon "position": "", //选手位置 "number": 33, //选手球衣号 "sport_id": 202, //运动ID "status": "", //服役状态 "integral": 0, //选手评分 "country_id": 0, //选手所属国家ID "update_time": 0 //选手信息最近的更新时间 } ], "transfer": { //转会相关数据 "transfer_from": [ //转出相关数据 { "player_id": 137374, //转会的选手ID "from_team_id": 13022, //来源队伍 "to_team_id": 8927, //目标队伍 "transfer_time": 1735574400, //转会时间 "transfer_fee": 0, //转会金额 "transfer_fee_desc": "", //转会金额描述 "transfer_type": 2, //转会类型足球：1租借 2租借结束 3转会 4退役 5选秀 6已解约 7已签约; 篮球:1-交易,2-签约 "free_agent": 0, //是否是自由球员 "transfer_desc": "" //转会描述 } ], "transfer_to": [ //转入相关数据 { "player_id": 419512, "from_team_id": 10089, "to_team_id": 13022, "transfer_time": 1709049600, "transfer_fee": 0, "transfer_fee_desc": "", "transfer_type": 1, "free_agent": 0, "transfer_desc": "" } "teams": [ //转会相关的队伍数据 { "id": 3990, "name": "圣地亚哥漫游者", "name_en": "Santiago Wanderers", "abbr": "漫游者", "logo": "https://img.xxx.png", "icon": "https://img.xxx.png" } ], "players": [ //转会相关的选手数据 { "id": 209564, "name": "丹尼尔·卡斯特罗", "name_en": "Daniel castro", "abbr": "卡斯特罗", "logo": "https://img.xxx.png", "icon": "" } ] }, "honor": [ //该队伍获得的相关荣誉 { "honor": { "id": 9, //荣誉ID "title": "甲级联赛冠军", //荣誉名称 "title_en": "", //荣誉英文名称 "logo": "https://img.xxx.png" //荣誉logo }, "years": [ //获得荣誉年份 "1957" ] } ] } ``` | 返回参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | id | int | 球队ID | | | name | string | 球队全称 | | | name_en | string | 球队英文名 | | | sport_id | int | 所属运动ID | | | abbr | string | 球队简称 | | | logo | string | 球队logo | | | country | string | 国家 | | | league_name | string | 所属联赛名称 | | | coach | string | 主教练 | | | venue | string | 场馆 | | | id | int | 选手ID | | | name | string | 选手名称 | | | name_en | string | 选手英文名 | | | team_id | int | 所属球队ID | | | abbr | string | 选手简称 | | | logo | string | 选手头像 | | | position | string | 选手位置 | | | lang | string | 多语言字段（球队名）|