直接答案

先对分片账号,取可用比赛,沿关系读 telemetry asset URL。按类型和 ID 建 included 索引,不全算玩家;比赛元数据和遥测分存,下载失败只重试该步。

车辆穿过开阔地形
车辆穿过开阔地形 · PUBG: BATTLEGROUNDS — PUBG Corporation / KRAFTON, Inc. · 来源页面 ↗

对上账号与平台分片

从官方支持的平台分片和目标账号开始。显示名可用于查询,不适合作永久主键;保存账号 ID 时保留平台。查不到先核对拼写和平台。Bearer Token 留在本地或服务器私有环境,不能放进公开 HTML 和 JavaScript。

按关系连接资源

不要把 included 中每个对象都算玩家。Roster 组织参赛者,participant 表示玩家在本局的参赛记录。先按资源类型和 ID 建索引,再读取 relationships。Asset、roster 与 participant 即使在同一响应中,也是不同资源;测试关联时保留原始响应。

传统建筑附近的摩托跳跃
传统建筑附近的摩托跳跃 · PUBG: BATTLEGROUNDS — PUBG Corporation / KRAFTON, Inc. · 来源页面 ↗

使用返回的遥测地址

找到关联的 telemetry asset,使用它给出的 URL,不拿日期和比赛 ID 自拼路径。官方说明该下载不需要 API 授权头。比赛响应与遥测文档分开保存,下载失败时不应丢掉已经获取的比赛资料。

按失败阶段处理

玩家查询失败,不必重试遥测;比赛成功、asset 失败时,只对失败步骤有限重试。限流按响应头与当前官方文档处理,不照抄固定配额。日志区分空结果、HTTP 错误与无效 JSON,让排查从正确阶段开始。

关联前验证资源身份

检查响应的顶级类型、ID 和关系。为参与者、队伍和资源建立独立索引。在将玩家分配到团队之前,先跟随比赛的队伍关系以及每个队伍的参与者关系。缺失的引用资源应产生明确的验证结果,而不是默默变为空团队。在派生表旁边存储原始 ID。如果后续聚合导致玩家重复,请在责怪遥测之前,先将连接路径与源响应进行比较。比赛资源和遥测事件文档是不同的输入,需要不同的解析器。

只重试失败阶段

记录请求阶段、HTTP 状态和资源 ID,但不记录承载令牌。区分不可用比赛、限流请求、资源传输失败和无效 JSON。使用文档化的响应信息进行有限次重试。官方遥测概述说明,资源下载不需要 API 授权头;避免将令牌发送给任意资源主机。成功的 HTTP 响应仍需验证其预期格式。缓存比赛元数据,这样重试遥测时无需重新解析玩家。绝不要求访问者将 API 密钥粘贴到公共静态页面。

具体决策示例

示例:玩家和比赛成功、遥测传输失败,保存前两步,只有限重试 asset;解析成功仍核对应比赛再计算。

适用范围与依据

先核已安装构建、平台和已开放功能。历史公告只说明对应版本,操作示例不冒称实测。

下次游玩时

  1. 密钥不进入网站。
  2. 按类型和 ID 关联。
  3. 使用返回的遥测地址。

本文官方参考资料

  1. Matches endpoint ↗资料采集日期:2026 年 11 月 16 日
  2. Players endpoint ↗资料采集日期:2026 年 11 月 16 日
  3. Telemetry overview ↗资料采集日期:2026 年 11 月 16 日
  4. API rate limits ↗资料采集日期:2026 年 11 月 16 日
  5. Making requests ↗资料采集日期:2026 年 11 月 16 日

引用来源不保证旧功能始终不变;遇到差异,以当前游戏内说明为准。