WD Stats API

WD Stats API、访问要求及数据使用条件。

在账号中创建密钥,并使用 Bearer 身份验证。限制:每个密钥每分钟 120 次请求、30 次并发,每个账号三个密钥。响应可能缓存一分钟。

你的账号 · OpenAPI 端点参考

https://wdstats.co.uk/api/v1
Authorization: Bearer wds_…
端点限制与假设
GET /api/v1/status当前赛季、已排名玩家,以及最近一次排名计算时间
GET /api/v1/seasons所有赛季、开始时间、玩家人数,以及进行中或已结束状态
GET /api/v1/seasons/{n}/payout游戏为某赛季剩余现金发放的金条
GET /api/v1/boards各排行榜的 ID、名称与数值
GET /api/v1/boards/{board}当前或已结束赛季的一页排行榜
GET /api/v1/players/{key}公开玩家档案:等级、XP、解锁、钱包、兵种,以及各榜排名
GET /api/v1/players/{key}/seasons玩家逐赛季总计
GET /api/v1/players/{key}/history玩家 XP 与等级,每日一个数据点
GET /api/v1/players/{key}/combat玩家在社区服务器的总计
GET /api/v1/players/{key}/matches玩家最近的社区对局
GET /api/v1/movers本周进步幅度最大的玩家
GET /api/v1/milestones按玩家列出的最新里程碑
GET /api/v1/community/leaderboard社区服务器排行榜
GET /api/v1/community/servers已连接的社区服务器
GET /api/v1/community/servers/{id}某个社区服务器及其领先玩家
GET /api/v1/patch-notesBulkhead 公告:标题与链接

错误使用 application/problem+json。协议字段名、错误代码及英文错误详情保持不变。

图片与组件

分享卡片、横幅与直播组件不需要 API 密钥。

/card/{key}.png · /card/top/{board}.png · WARDOGS 直播组件

API 条款

  1. 注明出处:凡展示数据之处,请显示“数据来自 WD Stats”,并链接至 wdstats.co.uk 或对应玩家资料。
  2. 保持更新:未经重新获取,不得保存玩家数据超过 24 小时;不再返回的玩家应移除。
  3. 不得复制网站:不得批量镜像排行榜或资料,不得转售数据或收费提供访问。
  4. 不得冒充:不得将数据称为 WARDOGS 或 Bulkhead 官方数据,也不得将自己的应用冒充 WD Stats。
  5. 尊重玩家:不得利用数据骚扰、跟踪玩家,或结合其他数据识别其身份。
  6. 每个应用使用一个密钥:不得把请求分散到多个密钥或地址,以绕过限制。
  7. 我们可进行调整:包括修改 API、降低限额,或撤销违反条款的密钥。服务免费并按现状提供。

破坏兼容性的变更使用新的 API 版本。引入版本 2 后,版本 1 至少继续可用三个月。