ZMYData API
足球数据 API 接入
面向商用客户开放的足球数据接口，提供赛程、比分、联赛、球队、球队赛季指标、 球员赛季指标和比赛高级数据。API 权限独立于 Plus、Pro、Max 会员， 客户只接入 ZMYData API，不直接连接数据库。
独立商用权限
API 按商用客户单独开通，入门版、标准版和企业版分别配置调用限制、权限范围和服务方式。
专属 API Key
客户付款或商务确认后，由后台生成独立 API Key，可禁用、续期、限流和绑定 IP 白名单。
统一数据出口
客户调用 goalxdata.com 的接口，服务端从内部数据库读取清洗后的标准字段，不暴露底层数据库。
数据时间边界
实时滚动数据
2026 年 6 月 1 日之后的数据按实时 API 业务处理，普通 API 默认只开放最近 30 天窗口。
历史全量授权
2026 年 6 月 1 日之前的数据，以及超出实时窗口的数据，统一归入企业全量授权口径。
未来赛程口径
已入库的未来赛程只返回赛前可用字段，不返回尚未发生的比分、赛后事件或赛后 xG。
接口示例
客户使用 API Key 请求 ZMYData 接口：
GET https://goalxdata.com/api/v1/football/matches?date=2026-07-01&limit=50 Authorization: Bearer zmy_live_xxxxxxxxxxxxxxxxxxxxx
也可以使用 `x-api-key` 请求头：
x-api-key: zmy_live_xxxxxxxxxxxxxxxxxxxxx
当前开放接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/football/matches | 比赛列表，支持日期、时间范围、状态和分页数量。 |
| GET | /api/v1/football/matches/{matchId} | 比赛详情，返回比分、球队、联赛、赛季指标和已清洗高级数据。 |
| GET | /api/v1/football/team-season-metrics | 球队赛季指标，按联赛和赛季维度返回 xG、xGA、场均数据。 |
| GET | /api/v1/football/player-season-metrics | 球员赛季指标，按球员、球队、联赛和赛季返回表现数据。 |
商务开通流程
客户确认用途、调用量、数据范围和服务等级后，由后台颁发 API Key。企业版可按合同配置历史全量授权、 IP 白名单、专属调用限制和定制字段。