足球数据 API：赛程、比分与积分榜 APIs

按足球相关名称搜索，获取带类型的候选项及可用于后续查询的球队或比赛 ID。必填 search，例如 Real Madrid。已验证响应包含 status='success' 和 response.suggestions。球队候选含 type、id、name、leagueId、leagueName；比赛候选含 id、matchDate、status.utcTime、started/finished/cancelled 状态及主客队 ID 和名称。不同类型的字段并不相同，score 是搜索排序分值，不是比赛比分。无匹配的测试请求成功返回 suggestions=[]。

使用面向球队的搜索接口发现俱乐部，再查询球队资料、球员名单或转会记录。search 为必填项。应检查返回数据、区分同名球队，并确认真正的球队 ID 后再复用。本接口尚无已验证响应样例；不能用综合搜索的字段、顺序或空结果格式直接推断球队专用搜索的结构。

用必填 search 查找候选比赛，为详情、比分和技术统计查询准备比赛 ID。选择候选时应核对实际参赛球队和开赛背景；球队名称并不能唯一确定一场比赛。本比赛专用搜索尚无已验证样例，不保证与综合搜索使用相同结构。

用必填 search 发现赛事候选，确认联赛 ID 后查询详情、比赛列表或积分榜。接入前需检查本接口实际返回的身份与区分信息；字段及无结果行为尚未验证。能搜索到一个赛事，不代表它在统计、积分榜等所有接口中都具备数据。

传入必填 search，查找球员候选并核对身份，再查询个人资料、头像或相关新闻。应保留实际返回的背景信息以区分同名球员，并使用确认后的 playerid。球员搜索尚无已验证响应，字段、分页以及空结果语义均需检查。

传入必填 date，格式为 YYYYMMDD，例如 20261008，读取当日比赛列表。已验证的 response.matches 含比赛 id、leagueId、主客队 id/name/longName/score，以及 statusId、tournamentStage、status.utcTime、started、finished、cancelled 和毫秒时间戳 timeTS；已结束样例还含 status.scoreStr 与 status.reason。一次日期查询曾返回分布在两个 UTC 日期的比赛，日历时区尚未明确。请转换 UTC 开赛时间后，按用户目标日期筛选。started=false 时的 0-0 不能当作最终平局。

用 YYYYMMDD 日期查询面向赛事浏览的每日比赛列表。必填参数仅有 date；虽然接口用途涉及联赛，但没有声明 leagueid 或时区参数，请勿自行添加。此变体尚无已验证响应，需检查实际层级、比赛 ID 和覆盖范围，不能默认它就是已验证每日赛程的按联赛分组版本。

用必填 leagueid 请求指定联赛的比赛列表，检查赛程、赛果与实际日期跨度。本接口未声明 season、date、round 或 page 参数，响应也尚未验证。制作归档前，应核实比赛 ID、状态字段和返回日期范围；列表名称不代表无限历史记录或所有联赛均受支持。

使用搜索或赛程返回的 eventid，查询比赛身份、双方球队、联赛背景、UTC 开赛时间及开始结束标志。已验证的 5868072 返回 response.detail，包含 matchId、matchName、matchRound、leagueId、leagueName、leagueRoundName、parentLeagueId、countryCode、homeTeam、awayTeam、matchTimeUTCDate、started 和 finished，也出现 teamColors 与 coverageLevel。该德比赛例已结束；coverageLevel='xG' 只是覆盖级别标签，不是预期进球数。此详情样例未包含最终比分。

使用搜索或赛程获得的必填 eventid，查询单场比赛比分，评估是否适合作为比分组件的数据来源。此比分响应尚未验证，字段以及未开赛、加时、点球的表示方式均不明确。展示赛果前需结合比赛状态核实语义；这个 GET 不代表固定更新频率或推送服务。

传入必填 eventid，读取单场状态并评估应用自身的刷新逻辑。本专用状态响应尚未验证，应独立确认真实状态字段，不能直接套用比赛详情中的 started 和 finished。明确处理未知、缺失及取消状态，不假设固定枚举或保证实时交付。

以必填 eventid 选择比赛双方，查询历史交锋信息；不是分别传入主客队 ID。响应尚未验证，应检查实际返回的交锋记录、日期跨度和比赛标识后再总结。返回记录不能证明涵盖完整历史，也不能预测下一场结果。

用必填 eventid 请求主队阵容，独立评估可用球员记录。尚未验证本接口响应，不能保证阵型、首发、替补或具体球员字段。先确认角色与标识，再绘制阵容或关联球队名单；缺失阵容数据不代表主队没有球员。

用必填 eventid 查询客队阵容，评估比赛面板中客队一侧的可用数据。本变体尚无已验证响应，需独立检查球员 ID、角色及可能的阵型，不能假设与主队结构相同。应区分覆盖不可用与真实空列表；阵容发布时点尚未明确。

用必填 eventid 请求单场比赛地点，评估用于赛事球场卡片的信息。尚未验证响应，球场名称、地址与坐标需从真实数据确认。俱乐部通常使用的主场不一定是该场比赛地点；缺失坐标时不要猜测位置。

传入必填 eventid，读取赛事关联的裁判信息，用于比赛资料单或执法安排研究。响应尚未验证，应确认实际可用的姓名、标识和安排细节。本接口不保证完整执法历史、纪律统计、安排确定性或所有赛事覆盖。

用必填 eventid 探索赛后集锦信息，检查是否有可用媒体元数据或链接。此响应尚未验证，不代表视频直播、可下载视频或媒体使用授权。请检查真实内容，区分集锦不可用与请求失败，嵌入或缓存前确认权限。

传入必填 leagueid，读取联赛球队名次和积分数据。已验证的 47 返回包含 20 支球队的英超积分榜。response.standing 中含 id、name、shortName、played、wins、draws、losses、scoresStr、goalConDiff、pts 和 idx；deduction、ongoing、qualColor 也出现过，但可能为 null。请保留返回顺序和 idx，不自行猜测同分排名规则。本接口未声明 season 参数。样例中的场次和积分可核对一致，但推广计算规则前仍需确认赛事计分与扣分制度。

传入必填 leagueid，查询联赛主场战绩表，评估作为总积分榜的场地拆分视图。主场响应尚未验证，不保证与总榜具有相同字段、排名规则或赛季范围。展示前核对指标和顺序，并清楚标注主场榜，不能把它当作联赛总排名。

传入必填 leagueid，查询独立于总榜的客场战绩视图。此响应尚无已验证样例，应确认真实指标、顺序和范围后再比较球队。本接口没有 season 参数，客场名次不能替代球队在联赛总榜中的位置。

用必填 leagueid 请求联赛进球榜，评估作为射手榜页面的数据来源。响应尚未验证，应确认球员 ID、进球总数、排名及实际统计期间后再发布。未声明赛季或历史总榜筛选，也不保证点球拆分、出场分钟或梦幻足球积分。

用必填 leagueid 请求助攻球员列表，评估用于组织进攻球员榜单的可用数据。尚无已验证响应，需确认球员身份、助攻指标、排名与时间范围。不要从接口名称推断预期助攻、创造机会、历史纪录或球员能力评价。

传入必填 leagueid，请求评分球员列表；排名展示前应核实评分语义。响应尚未验证，需检查评分值、排序、球员 ID 及可能的样本量背景。评分量尺、入榜资格与计算方式尚未明确，不应等同于梦幻积分或其他系统的评分。

传入必填 teamid，将球队 ID 解析为身份、国家、最近赛季、主要联赛与结构化球场资料。已验证的 8633 对应皇家马德里，response.details 含 id、type、name、shortName、country、gender、latestSeason、primaryLeagueId、primaryLeagueName 和 teamColor。样例 sportsTeamJSONLD.location 含球场名称、地址与坐标；faqJSONLD 里的下场比赛和球场问答是带日期的快照，不是保证实时更新的赛程流。athlete 数组为空，球员名单应另查球队阵容接口。

传入必填 teamid，请求球队球员列表，为名单页和个人查询检查球员身份。响应尚未验证，球员字段、角色分组与完整性均需确认。球队详情样例中 athlete 为空，不能据此推断本名单接口的结构。名单增减应作为待复核信号，不自动认定发生转会。

用必填 teamid 请求队徽信息，核查响应格式后再为球队组件增加图片。尚无已验证样例，不能保证直接返回图片而非 JSON 元数据。嵌入或缓存前检查内容类型、资源引用和使用权限；缺失队徽时保留易读的球队名称。

用必填 leagueid 请求赛事球队列表，检查俱乐部目录和球队 ID 的可用性。尚无已验证样例，球队字段、参赛期间与完整性仍不明确。发布当前赛季全部球队前应核实真实范围。本目录与主队、客队列表分开，也不是已经验证的积分榜。

传入必填 leagueid，请求主队列表并检查实际范围，再评估主队选择视图。此响应尚未验证，应确认标识、分组及收录语义；名称不代表唯一球队集合、完整阵容或主场积分榜。应与通用球队目录和客队列表比较，不将三者视为可互换。

用必填 leagueid 请求客队列表，核实含义后再制作客队选择视图。此响应尚无已验证样例，需检查身份、层级与真实范围。目录名称不能证明是独立俱乐部成员集合或客场表现表；与主队及全队列表的差异应以数据为准。

使用球员搜索或已核验名单中的必填 playerid，请求个人资料，并仅用实际返回字段组装页面。671529 是目录示例输入，但本详情响应尚未验证。展示前应确认身份和属性，不能从名称推断职业履历、伤病、身价或固定个人简介字段。

传入必填 playerid，请求球员图片信息并确认表示方式，再展示头像。尚无已验证响应，不能保证直接可嵌入图片，也不保证与球队队徽同格式。渲染或缓存前验证内容与权限；没有可用资源时保留球员姓名。

请求足球国家目录，检查国家导航和赛事发现所需的代码参考。此 GET 无操作参数。响应尚未验证，构建选择器前需检查名称、代码及分组，不预设采用某种代码标准，也不能直接假设可用于赔率接口；赔率示例代码为 BR 和 UK。

请求带国家关联的赛事列表，检查联赛与国家关系以便导航和标注。此 GET 无操作参数。响应尚未验证，分组、标识及国内联赛覆盖不明确；不能从目录名称推断完整赛事集合或详细统计覆盖。

请求热门联赛选择集，评估作为首次使用时的赛事发现入口。此 GET 无操作参数。响应与排序尚未验证，应先确认可用赛事身份；将结果称为返回的精选集合，不当作独立测量的全球热度排名或完整联赛目录。

传入必填 leagueid，核实赛事身份后为相关赛程和积分榜标注名称。尚无已验证详情样例，创建专题页前应确认身份、描述属性和可用背景。本接口未声明赛季或国家筛选；联赛身份有效不代表每个相关接口都有数据。

用必填 leagueid 请求赛事徽标信息，核实表示方式后再展示。此响应尚未验证，应确认是图像内容还是元数据及是否有可用资源。缓存或传播前检查使用权限；徽标不可用时保留赛事名称。

请求赛季目录，检查实际赛季字符串后，用于明确支持 season 的接口。此 GET 不接收 leagueid 或其他操作参数。响应尚未验证，应检查值和排序；全局赛季列表不保证每个赛事都支持所有赛季，也不会给其他接口增加 season 筛选。

用必填 leagueid 查询轮次，发现真实 roundid 和标签后再查轮次详情。此响应尚未验证，应检查轮次身份、名称及顺序；显示轮数不一定是通用 roundid。本接口没有 season 参数。

使用联赛轮次列表发现的必填 roundid 查询单个轮次。没有声明 leagueid、season 或 date。响应尚未验证，目录中的 '1' 不能证明是全局有效的轮次 ID。跨赛事缓存前检查身份与分组，并优先取得真实返回标识。

用必填 leagueid 请求轮次球员信息，检查分组后评估比赛周球员专题。契约只接收联赛，不接收 roundid 或 season。响应尚未验证，需核实轮次背景、球员身份和顺序后再称为选拔、排名或表现记录；不应未经证据声称是周最佳阵容或梦幻积分。

传入必填 leagueid，探索按赛季组织的奖杯列表，为赛事荣誉页面准备索引。响应尚未验证，应检查赛季、奖杯记录与可用标识，不能当作完整历史档案。取得可用赛季值后，再调用独立的赛季荣誉详情。

同时传入必填 leagueid 与 season，请求某赛事某赛季的奖杯详情。目录示例 season='2023/2024'，应从已核实赛季或荣誉数据确认支持值，不保证所有组合有效。此响应尚未验证，获奖者、奖项及其他属性仅在实际返回时展示。

用必填 eventid 请求比赛统计这一变体，检查指标后再选数据来源。响应尚未验证，具体字段、单位和时段范围未知。它与事件统计变体是独立操作，不能假设结构或数值相同；分析所用原始快照应保留操作身份。

传入必填 eventid，检查事件统计变体提供的球队指标和单位。此响应尚未验证，展示前应确认指标名称、双方归属与时段范围。它与比赛统计是不同操作；名称相近不代表内容相同，也不代表可以安全自动回退。

用必填 eventid 请求事件统计系列的上半场变体，分析前核实统计时段和指标。此响应尚未验证，应检查指标、单位及上半场是否结束后再生成中场总结。它与比赛统计系列的上半场变体分开，不保证结构相同。

传入必填 eventid，读取事件统计系列的下半场变体。尚无已验证响应，比较前应确认时段定义、单位以及加时处理。整场数值不一定等于两半场简单相加，特别是百分比、平均值或范围不同的指标。

使用必填 eventid 请求比赛统计系列的上半场变体，评估为分时段战报提供数据。响应尚未验证，应检查时段、字段与单位，并与独立的上半场事件统计比较后，再选解析器或回退来源。

用必填 eventid 请求比赛统计系列的下半场变体，检查是否适合作为第二时段战报数据。响应尚未验证，应独立于下半场事件统计核实范围、字段和单位。保留本变体来源，未经兼容验证不要合并重叠或冲突指标。

传入必填 page，例如 '1'，读取通用转会列表并评估可续采的发现流程。尚无已验证响应，页大小、总量、记录字段和完成状态未知。应检查分页行为，保留已核实标识用于去重；只有状态证据支持时，才能将一条转会标为已完成。

用必填 page 请求精选转会列表，核实选择语义后再制作摘要。尚无已验证样例，应检查记录字段、分页和顺序。名称不证明按转会费排名、最贵顺序或交易已完成；此集合需与身价转会列表分开理解。

用必填 page 请求身价相关转会选择集，检查估值表示后再比较记录。尚无已验证响应，应确认身价字段、币种、日期、顺序和转会状态。球员身价与实付转会费不是同一概念，名称不证明最高费用排名或某种估值方法。

用必填 leagueid 请求赛事转会列表，评估联赛追踪与编辑研究。响应尚未验证，没有 page、season 或转会窗口参数。计数前需确认记录范围、日期、身份和状态，不能假设覆盖某个窗口的全部交易。

传入必填 teamid，查询球队转入列表，评估与当前名单分开的新援视图。尚无已验证样例，应确认球员、日期、租借或永久转会标记及真实状态。出现转入记录不代表球员已在当前名单，也不自动表示签约完成。

用必填 teamid 查询转出列表，利用实际状态和日期评估离队页面。响应尚未验证，将记录称为已完成的永久离队前，必须确认身份、时间和转会类型。不能因一条转出记录出现，就自动移除名单球员或推断解约。

传入必填 teamid，查询与转入转出分开的续约列表。尚无已验证响应，应从真实数据确认球员身份、生效日期、合同条款和状态后再发布。续约不应计为新援；此读取没有谈判或合同管理能力。

请求热点新闻集合，检查故事元数据与可用链接后评估发现页。此 GET 无操作参数。响应尚未验证，应核实标题、日期、来源和顺序。热度方法、时效保证与全文可用性均未建立，返回内容引用不授予文章转载许可。

同时传入必填 teamid 与 page，读取与球队关联的新闻页。响应尚未验证，发布前需确认故事元数据、球队相关性、来源链接和分页行为。球队关联不代表独家覆盖或转载权，本接口未声明语言筛选。

提供必填 leagueid 与 page，查询赛事关联新闻，评估具有可核查来源的阅读专区。响应尚未验证，应检查元数据、赛事相关性、分页和真实文章链接。不要推断全文、固定页大小或固定发布时间；内容再利用需要适当授权。

传入必填 playerid 和 page，查询球员关联新闻。playerid 必须来自球员搜索或已核验名单，不能用俱乐部 ID 代替。响应尚未验证，元数据、相关性和分页未知。保留来源链接，复用前检查权限，也不要假设每篇报道都能唯一对应同名球员。

同时传入必填 eventid 与 countrycode，查询地区相关赔率，并核验市场可用性及数值语义。已记录国家示例为 BR 和 UK。响应尚未验证，机构字段、市场类型、数字格式和覆盖均不明确，目标国家接受值需检查。本读取不提供下注、比赛预测或收益保证。

用必填 eventid 请求比赛投票信息，作为赛前预览或球迷页面的只读补充。响应尚未验证，应检查投票元数据和背景后展示。此 GET 不提供投票提交能力；球迷意见不能当作机构赔率、校准概率或保证准确的预测。

传入必填 eventid，请求球迷投票结果，核实实际汇总后再描述群体意见。响应尚未验证，票数、比例、选项标签和样本量未知。展示前确认字段，为快照保留时间；球迷观点不是机构价格、校准胜率或可靠预测。