IGDB API v4

IGDB 官方游戏资料 API 使用 Twitch OAuth2 和 Client-ID/Bearer headers，通过 POST 查询体选字段及筛选；非商业使用免费，文档限每秒4请求、最多8并发，未调用。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：电子游戏目录与发行元数据查询 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 28e8a751b11c38acbb6954a8a29fc2730edc0e356b90844b362210c8a69e2ae3

本次官方文档给出 https://api.igdb.com/v4 基础地址，代表游戏查询为 POST https://api.igdb.com/v4/games。查询体使用字段选择、where、sort、search、limit 等 APICalypse 语法，非普通 JSON 请求体。使用前需 Twitch 账户、2FA 和 Confidential 类型开发者应用，通过 client_credentials 获得 access token。本文只整理已有公开文档，未创建账户/应用、取得 secret/token 或执行任何 API 请求。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-ca412753e9c357bfe4572beb · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-ca412753e9c357bfe4572beb
名片版本: 2
资料更新: 2026-10-24T18:20:46.3751740+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

Client-ID 与OAuth Bearer <caller_supplied_token> headers。
POST查询体使用fields选择返回字段，where过滤、sort排序、search文本搜索、limit限制结果数。
不同资源使用对应v4路径；本文代表games，未将其他端点参数混用。

输出

按所选字段返回游戏数据；官方示例可请求游戏name、release_dates.human、involved_companies等。
示例通过application/json解析；完整games响应schema、关联展开和可空字段未在本次整理中确认。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: POST

鉴权：OAuth 授权。文档使用 Twitch OAuth2 client_credentials：Client ID/Secret 换取access_token，再发送 Client-ID 和 Authorization: Bearer <access_token>。token有效期由expires_in返回，不能以样例固定天数保证。

运行前提

Twitch账户启用2FA，在Developer Portal注册Confidential应用并取得Client ID/Secret。
按官方流程获得OAuth access token；本次未请求认证端点。
API调用同时发送Client-ID和Bearer token headers，并以查询语法指定字段/筛选。

公开请求示例

{
  "body": "fields name; limit 10;",
  "documentation_text": "\u6587\u6863\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1APOST https://api.igdb.com/v4/games\uFF1BClient-ID: \u003Cclient_id\u003E\uFF1BAuthorization: Bearer \u003Caccess_token\u003E\uFF1Bbody \u4E3A fields name; limit 10;\u3002",
  "method": "POST",
  "url": "https://api.igdb.com/v4/games"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

限非商业免费。正文明确IGDB API非商业使用在Twitch Developer Service Agreement条款下免费；商业用途需商业合作，费用和条件未给。本次不将其扩为无限额或商业免费。

价格来源 · 未知

资料去向

提供者服务器。Client-ID、token和查询发送到IGDB/Twitch相关托管服务；完整日志保留、驻留及资料再分发条件未由本次读取段落确认。

限制

文档限每秒4请求，超过可返回429；最多8个同时未完成请求。
不允许直接浏览器请求，会遇CORS；本次未配置代理或绕过限制。
OAuth token会到期，应以实际expires_in处理；具体账户或token能否访问未验证。
文档中旧字段/枚举有弃用迁移提示，具体使用应核对应当前字段定义。
未调用games、其他资源或认证端点。

仍需核对

实际Twitch账户、应用/secret、token及访问权限未知。
商业合作价格、具体合同/资料再分发条件及其他配额未知。
完整games字段schema、分页最大值和实际数据覆盖未整理验证。
数据保留和驻留条件未知。
未注册应用、认证、运行示例或请求游戏数据。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:09:40.3985399+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

IGDB API docs · 官方文档 · 2026-10-24T18:09:40.3985399+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://api-docs.igdb.com/",
  "final_url": "https://api-docs.igdb.com/",
  "status_code": 200,
  "title": "IGDB API docs",
  "description": null,
  "checked_at": "2026-10-24T18:09:40.3985399\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-ca412753e9c357bfe4572beb",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://api-docs.igdb.com/"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。