足球 API 教练-比赛统计、荣誉、转会、伤病/停赛历史接口文档

接口说明

按需请求

请求方式: GET
请求地址: https://api.superscore.cn/football/statistics/coach
Content-Type: application/x-www-form-urlencoded;charset=UTF-8

请求头与鉴权

字段	类型	必填	文档示例值	说明
`token`	string	是	`传商户KEY`	token(传商户KEY)仅供测试,正式站请设置IP

商户密钥仅保存在自己的服务端。测试 token 与正式 IP 授权的适用范围以本表及账户授权说明为准。

请求参数

Query 查询参数

字段	类型	必填	文档示例值	说明
`coachId`	int32	是	`0`	教练ID

示例值用于说明字段；比赛、球队、联赛等 ID 应从实际接口取得，不能直接使用占位值。字段中的日期、枚举、分页范围与更新建议完整保留原始说明。

调用示例

替换 YOUR_MERCHANT_KEY、YOUR_MATCH_ID 等占位值后，在已授权的服务端调用。示例不会在本页面发起真实请求。

cURL

curl --get 'https://api.superscore.cn/football/statistics/coach' \
  --header 'token: YOUR_MERCHANT_KEY' \
  --data-urlencode 'coachId=YOUR_COACH_ID'

JavaScript / Node.js

// 仅在服务端保存商户密钥；替换示例占位值。
const url = new URL("https://api.superscore.cn/football/statistics/coach");
url.search = new URLSearchParams({
  "coachId": "YOUR_COACH_ID"
});
const response = await fetch(url, {
  method: "GET",
  headers: {
  "token": "YOUR_MERCHANT_KEY"
}
});
if (!response.ok) throw new Error('HTTP ' + response.status);
const result = await response.json();
if (result.success !== true) throw new Error(String(result.message || result.code));
console.log(result.data);

Python 标准库示例

# 标准库示例；商户密钥仅保存在服务端。
import json
from urllib.parse import urlencode
from urllib.request import Request, urlopen

parameters = {
  "coachId": "YOUR_COACH_ID"
}
headers = {
  "token": "YOUR_MERCHANT_KEY"
}
url = "https://api.superscore.cn/football/statistics/coach"
if parameters:
    url += '?' + urlencode(parameters)
with urlopen(Request(url, headers=headers, method="GET"), timeout=15) as response:
    result = json.load(response)
if not result.get('success'):
    raise RuntimeError(result.get('message') or result.get('code'))
print(result.get('data'))

返回参数

字段路径保留完整层级；[] 表示数组元素，<key> 表示按数据内容变化的映射键。success、code、message 与 data 均按接口定义列出。

字段路径	类型	说明与枚举
`success`	boolean	状态码
`code`	string	状态编号
`message`	string	描述
`data`	object	数据
`data.coach`	object	教练基础信息
`data.coach.coachId`	int32	教练ID
`data.coach.nameEn`	string	教练名称（英文）
`data.coach.nameShortEn`	string	教练短名称（英文）
`data.coach.nameZh`	string	教练名称（中文）
`data.coach.nameShortZh`	string	教练短名称（中文）
`data.coach.nameZht`	string	教练名称（繁体中文）
`data.coach.nameShortZht`	string	教练短名称（繁体中文）
`data.coach.firstName`	string	名
`data.coach.lastName`	string	姓
`data.coach.teamId`	int32	球队ID
`data.coach.countryId`	string	国家ID
`data.coach.age`	string	年龄
`data.coach.birthDate`	string	生日
`data.coach.birthCountryId`	string	出生国家
`data.coach.birthPlace`	string	出生地
`data.coach.height`	string	身高
`data.coach.weight`	string	体重
`data.coach.image`	string	教练图片
`data.stats`	object	教练统计
`data.stats.played`	int32	执教场次
`data.stats.won`	int32	胜
`data.stats.drawn`	int32	平
`data.stats.lost`	int32	负
`data.stats.winRate`	double	胜率
`data.history`	array	执教历史
`data.history[].teamId`	int32	球队ID
`data.history[].team`	object	球队数据
`data.history[].team.teamId`	int32	球队ID
`data.history[].team.type`	int32	类型：0俱乐部,1国家队
`data.history[].team.nameEn`	string	球队名称（英文）
`data.history[].team.nameShortEn`	string	球队短名称（英文）
`data.history[].team.nameZh`	string	球队名称（中文）
`data.history[].team.nameShortZh`	string	球队短名称（中文）
`data.history[].team.nameZht`	string	球队名称（繁体中文）
`data.history[].team.nameShortZht`	string	球队短名称（繁体中文）
`data.history[].team.countryId`	string	国家ID
`data.history[].team.founded`	string	成立时间
`data.history[].team.venueId`	int32	球场ID
`data.history[].team.image`	string	球队图片
`data.history[].team.coachId`	int32	教练ID
`data.history[].startDate`	string	开始日期
`data.history[].endDate`	string	结束日期
`data.history[].played`	int32	场次
`data.history[].won`	int32	胜
`data.history[].drawn`	int32	平
`data.history[].lost`	int32	负
`data.honors`	array	荣誉列表
`data.honors[].honorId`	int32	荣誉ID
`data.honors[].name`	string	荣誉名称
`data.honors[].season`	string	赛季
`data.transfers`	array	转会列表
`data.transfers[].transferId`	int32	转会ID
`data.transfers[].playerId`	int32	球员ID
`data.transfers[].player`	object	球员数据
`data.transfers[].player.playerId`	int32	球员ID
`data.transfers[].player.nameEn`	string	球员名称（英文）
`data.transfers[].player.nameShortEn`	string	球员短名称（英文）
`data.transfers[].player.nameZh`	string	球员名称（中文）
`data.transfers[].player.nameShortZh`	string	球员短名称（中文）
`data.transfers[].player.nameZht`	string	球员名称（繁体中文）
`data.transfers[].player.nameShortZht`	string	球员短名称（繁体中文）
`data.transfers[].player.firstName`	string	名
`data.transfers[].player.lastName`	string	姓
`data.transfers[].player.number`	string	号码
`data.transfers[].player.age`	string	年龄
`data.transfers[].player.position`	int32	位置：0位置,1守门员,2后卫,3中场,4前锋
`data.transfers[].player.countryId`	string	国籍
`data.transfers[].player.birthDate`	string	生日
`data.transfers[].player.birthCountryId`	string	出生国家
`data.transfers[].player.birthPlace`	string	出生地
`data.transfers[].player.height`	string	身高
`data.transfers[].player.weight`	string	体重
`data.transfers[].player.preferredFoot`	int32	首选脚：0未知,1左脚,2右脚
`data.transfers[].player.marketValueEur`	string	市值欧元
`data.transfers[].player.image`	string	球员图片
`data.transfers[].fromTeamId`	int32	原球队ID
`data.transfers[].fromTeam`	object	原球队数据
`data.transfers[].fromTeam.teamId`	int32	球队ID
`data.transfers[].fromTeam.type`	int32	类型：0俱乐部,1国家队
`data.transfers[].fromTeam.nameEn`	string	球队名称（英文）
`data.transfers[].fromTeam.nameShortEn`	string	球队短名称（英文）
`data.transfers[].fromTeam.nameZh`	string	球队名称（中文）
`data.transfers[].fromTeam.nameShortZh`	string	球队短名称（中文）
`data.transfers[].fromTeam.nameZht`	string	球队名称（繁体中文）
`data.transfers[].fromTeam.nameShortZht`	string	球队短名称（繁体中文）
`data.transfers[].fromTeam.countryId`	string	国家ID
`data.transfers[].fromTeam.founded`	string	成立时间
`data.transfers[].fromTeam.venueId`	int32	球场ID
`data.transfers[].fromTeam.image`	string	球队图片
`data.transfers[].fromTeam.coachId`	int32	教练ID
`data.transfers[].toTeamId`	int32	新球队ID
`data.transfers[].toTeam`	object	新球队数据
`data.transfers[].toTeam.teamId`	int32	球队ID
`data.transfers[].toTeam.type`	int32	类型：0俱乐部,1国家队
`data.transfers[].toTeam.nameEn`	string	球队名称（英文）
`data.transfers[].toTeam.nameShortEn`	string	球队短名称（英文）
`data.transfers[].toTeam.nameZh`	string	球队名称（中文）
`data.transfers[].toTeam.nameShortZh`	string	球队短名称（中文）
`data.transfers[].toTeam.nameZht`	string	球队名称（繁体中文）
`data.transfers[].toTeam.nameShortZht`	string	球队短名称（繁体中文）
`data.transfers[].toTeam.countryId`	string	国家ID
`data.transfers[].toTeam.founded`	string	成立时间
`data.transfers[].toTeam.venueId`	int32	球场ID
`data.transfers[].toTeam.image`	string	球队图片
`data.transfers[].toTeam.coachId`	int32	教练ID
`data.transfers[].type`	int32	转会类型
`data.transfers[].fee`	string	转会费
`data.transfers[].date`	string	转会日期
`data.leagueStats`	array	按联赛统计
`data.leagueStats[].leagueId`	int32	联赛ID（0=全部）
`data.leagueStats[].leagueName`	string	联赛名称
`data.leagueStats[].played`	int32	场次
`data.leagueStats[].won`	int32	胜
`data.leagueStats[].drawn`	int32	平
`data.leagueStats[].lost`	int32	负
`data.leagueStats[].winRate`	double	胜率
`data.recentMatches`	array	近期比赛
`data.recentMatches[].matchId`	int32	比赛ID
`data.recentMatches[].leagueId`	int32	联赛ID
`data.recentMatches[].leagueName`	string	联赛名称
`data.recentMatches[].dateTime`	string	比赛时间
`data.recentMatches[].homeName`	string	主队名称
`data.recentMatches[].awayName`	string	客队名称
`data.recentMatches[].homeScore`	int32	主队得分
`data.recentMatches[].awayScore`	int32	客队得分
`data.characters`	array	球队特点
`data.characters[].category`	int32	分类：1=进攻, 2=防守, 3=风格
`data.characters[].level`	int32	等级：1=强/高, 2=弱/低
`data.characters[].name`	string	特点名称

响应结构示例

下面的值仅展示字段类型，不是实时数据或真实调用结果。动态 map 的键取决于实际返回，不编造固定字段。

展开完整 JSON 结构

{
  "success": false,
  "code": "示例字符串",
  "message": "示例字符串",
  "data": {
    "coach": {
      "coachId": 0,
      "nameEn": "示例字符串",
      "nameShortEn": "示例字符串",
      "nameZh": "示例字符串",
      "nameShortZh": "示例字符串",
      "nameZht": "示例字符串",
      "nameShortZht": "示例字符串",
      "firstName": "示例字符串",
      "lastName": "示例字符串",
      "teamId": 0,
      "countryId": "示例字符串",
      "age": "示例字符串",
      "birthDate": "示例字符串",
      "birthCountryId": "示例字符串",
      "birthPlace": "示例字符串",
      "height": "示例字符串",
      "weight": "示例字符串",
      "image": "示例字符串"
    },
    "stats": {
      "played": 0,
      "won": 0,
      "drawn": 0,
      "lost": 0,
      "winRate": 0
    },
    "history": [
      {
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "startDate": "示例字符串",
        "endDate": "示例字符串",
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0
      }
    ],
    "honors": [
      {
        "honorId": 0,
        "name": "示例字符串",
        "season": "示例字符串"
      }
    ],
    "transfers": [
      {
        "transferId": 0,
        "playerId": 0,
        "player": {
          "playerId": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "firstName": "示例字符串",
          "lastName": "示例字符串",
          "number": "示例字符串",
          "age": "示例字符串",
          "position": 0,
          "countryId": "示例字符串",
          "birthDate": "示例字符串",
          "birthCountryId": "示例字符串",
          "birthPlace": "示例字符串",
          "height": "示例字符串",
          "weight": "示例字符串",
          "preferredFoot": 0,
          "marketValueEur": "示例字符串",
          "image": "示例字符串"
        },
        "fromTeamId": 0,
        "fromTeam": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "toTeamId": 0,
        "toTeam": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "type": 0,
        "fee": "示例字符串",
        "date": "示例字符串"
      }
    ],
    "leagueStats": [
      {
        "leagueId": 0,
        "leagueName": "示例字符串",
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "winRate": 0
      }
    ],
    "recentMatches": [
      {
        "matchId": 0,
        "leagueId": 0,
        "leagueName": "示例字符串",
        "dateTime": "示例字符串",
        "homeName": "示例字符串",
        "awayName": "示例字符串",
        "homeScore": 0,
        "awayScore": 0
      }
    ],
    "characters": [
      {
        "category": 0,
        "level": 0,
        "name": "示例字符串"
      }
    ]
  }
}

错误处理与使用说明

先检查 HTTP 状态，再解析 JSON；网络失败或非 JSON 响应不能当作成功。
业务响应 success 为 false 时，读取 code 和 message；不要把业务错误与 HTTP 状态混为一谈。
保存原始错误码、请求时间及接口路径用于排查，日志中移除商户密钥。
按该接口的数据更新建议、账户授权和调用频率请求；日期和时间戳单位以字段说明为准。
允许字段缺失或数据为空，按接口中的稳定 ID 关联资料，不依赖数组顺序。