Bungie.Net API

概览

GitHubGitHub

Bungie.Net API 是 Bungie 为其旗下 Destiny 系列游戏提供的官方 API 资源仓库。该仓库包含 OpenAPI 规范文件，供第三方开发者构建与 Destiny 游戏数据交互的应用程序。 ## 主要能力 - **游戏数据查询**：支持获取角色活动、物品定义、赛季通行证、供应商商品等 Destiny 2 核心游戏数据。 - **持续更新**：随游戏版本迭代同步更新 API 字段，例如新增 Portal 活动、Featured Quests 图片、装备层级图标覆盖等。 - **组件化响应**：通过不同的 Component 类型（如 `DestinyProfileComponent`、`DestinyCharacterActivitiesComponent`）按需请求数据，减少冗余传输。 - **枚举与定义管理**：维护大量游戏内枚举值（如 `DestinyActivityModeType`、`DestinyGameVersions`）和静态定义（如 `DestinyInventoryItemDefinition`）。 ## 适用场景 适合开发 Destiny 2 相关的第三方工具、数据统计网站、Discord 机器人或移动端伴侣应用的开发者。通过查阅此仓库的 OpenAPI 规范和更新日志，可以了解当前可用的端点、数据结构以及近期新增或废弃的字段。 ## 文档 完整文档托管在 GitHub Pages 上，提供多页面版本和单页长文档两种阅读方式。

Q&A

完整的 API 文档在哪里查看？由 AI 生成

完整文档地址为 https://bungie-net.github.io/multi/index.html ，也提供了一个单页长文档版本：https://bungie-net.github.io 。

这个仓库包含什么内容？由 AI 生成

该仓库包含 Bungie.net API 的资源文件和 OpenAPI 规范（openapi-spec），用于描述 Destiny 相关接口的数据结构与端点。

如何处理 GetProfile 接口的缓存问题？由 AI 生成

可以使用 DestinyProfileResponse 中的 responseMintedTimestamp 和 secondaryComponentsMintedTimestamp 字段来判断和处理过期的缓存响应。

Fireteam Finder API 还能用吗？由 AI 生成

根据 2025-07-29 的更新日志，不对第三方应用开放的 Fireteam Finder API 规范已被移除。