DFT SDK

构建你的第一个网球数据集成。

将应用连接到比赛记录、逐分序列与球员统计。从免费请求开始,然后在整个集成中使用同一 API 密钥与网球实体标识。

GET /onboarding/v1/match

请求
import json, os
from urllib.request import Request, urlopen

request = Request(
    "https://api.datafortennis.com/onboarding/v1/match",
    headers={"Authorization": "Bearer " + os.environ["DFT_API_KEY"]}
)
with urlopen(request, timeout=15) as response:
    match_response = json.load(response)
print(json.dumps(match_response, indent=2))

使用标准 HTTP 和环境变量 DFT_API_KEY。免费路由返回一场比赛;请在 playground 使用自己的密钥运行。

免费比赛响应包含什么。

GET /onboarding/v1/match 返回一场规范比赛,含球员、赛事届次和比分上下文。

data.sides[].members[].name
比赛每一方中的球员姓名,免费比赛响应中可获取。
data.edition.name
返回比赛对应的赛事届次名称。
data.score.display
可读的比赛比分。需要每盘比分时保留结构化 sets 数据。
meta.release_id
响应所用的数据版本,与返回比赛一起保存。

从密钥到比赛记录。

  1. 创建免费 API 密钥。

    打开 playground,创建密钥并将密钥保存在环境中。

    打开 API playground
  2. 检查比赛响应。

    在应用中使用响应前,检查球员、届次、比分和数据版本。

    阅读 API 参考文档
  3. 添加实时更新。

    使用 TypeScript 实时客户端维护本地比赛状态、处理重连并处理数据流检查点。

    获取 TypeScript 实时客户端

常见问题

构建第一个实用请求。

创建免费密钥,在 playground 运行比赛请求,再复制到应用中。