Steam 与 CS2 问题解答
先找到直接答案，再阅读包含请求、字段和示例的指南。
更新日期
共 12 个答案
库存与隐私
为什么刚交易得到的 CS2 物品没有出现在公开库存中？
Steam 可能向其他库存查看者隐藏近期获得的物品。七天交易保护是另一项规则。WOK 可选的交易视图候选物品，其保护状态未经验证，覆盖范围也可能不完整；金额总计仍只包含公开物品。公开结果中缺少某件物品，并不能证明它已丢失。
阅读指南缓存与限额
如何处理 Steam 库存 429 和 WOK 配额错误？
WOK 的每分钟限额会返回 HTTP 429，套餐配额耗尽可能返回 402。Steam 暂时没有可用容量时，原生库存接口可能返回 HTTP 200 和 status=limited。遵守 Retry-After，用延迟和随机抖动限制重试次数。重复读取应利用缓存；任何 API 都无法保证 Steam 始终可用。
阅读指南缓存与限额
能否不再次请求 Steam，只更新库存价格？
可以。正常读取有效缓存时会应用本地目录价格。refresh_prices=1 仅基于缓存更新；缓存缺失或过期时返回 404 inventory_cache_miss。库存年龄与价格更新时间应分别检查。请求仍消耗 WOK 配额，refresh_prices 不能与 no_cache 同时使用。
阅读指南缓存与限额
一批库存查询只消耗一个请求配额单位吗？
批量请求按每个唯一的 SteamID 与游戏组合消耗一个单位，最多支持 20 个 SteamID、四款游戏和 80 个组合。每个未命中缓存的组合都可能需要单独请求 Steam。结果和错误按组合返回，单个失败不会丢弃已完成的库存。
阅读指南密钥与访问
库存请求中的 SteamID64、AppID 和 context ID 分别是什么？
SteamID64 标识账号，应将其 17 位数字保存为字符串。AppID 标识游戏，context ID 选择该游戏的库存。CS2 使用 AppID 730、context 2；WOK 的 game=cs2 会自动选择它们。自定义名称的个人资料链接应先通过资料接口解析为 SteamID64。
阅读指南CS2 检视与图像
如何通过 inspect 链接获取 CS2 磨损、图案种子、贴纸和挂件？
拥有 Inspect 权限后，将 Steam inspect 链接发送到 POST /v1/cs2/inspect。现代编码链接在本地解析，旧链接通过 Steam Game Coordinator 工作进程处理。检查 status=resolved 和 capabilities。未知字段保留 null；Steam 暂时失败会返回 503 和 Retry-After。配件元数据不能确定物品价格。
阅读指南价格与来源
部分物品没有价格时，Steam 库存价值如何计算？
WOK 将每件物品所选价格乘以持有数量，再汇总有价格的物品。缺失价格保留 null，并计入 unpriced。top 只缩短物品列表，不改变总计。按市场名称估算的价格不包含具体 CS2 物品的磨损、图案或已贴贴纸溢价。
阅读指南价格与来源
为什么 API 中的物品价格与 Steam 市场显示的价格不同？
应比较相同的来源、价格统计指标、币种和观察时间。保存的挂牌价、成交中位数和求购价含义不同。WOK 目录报价使用 USD，当前 CS2 挂牌使用 Steam 返回的币种。如果不能接受自动使用其他来源，请指定 price_source 和 strict=1。
阅读指南CS2 检视与图像
CS2 截图与交互式 3D Viewer 包含在同一套餐中吗？
Free 和通用 API 套餐包含截图生成，专用套餐则取决于接口权限。新渲染任务返回 202；等待 Retry-After 后查询结果，并检查渲染及配件警告。交互式 3D 需要单独的 Viewer 订阅；Viewer Trial 每 30 天提供 10 次打开机会。
阅读指南密钥与访问
为什么免费 WOK API 需要加入 Discord 社区？
Free Developer 和 Viewer Trial 要求关联 Discord 账号，并持续保持 WOK 社区成员资格。加入社区，在账户中关联 Discord，再激活访问。未满足成员要求会返回 403 discord_required；验证暂时中断会返回 503 和 Retry-After。当前限额可通过 GET /v1/key 查看。
阅读指南密钥与访问
连接 WOK 需要 Valve Steam API 密钥吗？
WOK 接口使用套餐激活后在账户中发放的 WOK 密钥。Valve 用户密钥、Steamworks 发行商密钥或其他服务商密钥不能替代它。请从服务器通过 Authorization: Bearer 请求头发送 WOK 密钥。GET /v1/key 可查看权限及限额，不消耗请求配额单位。
阅读指南没有匹配的问题。请尝试更短的关键词或其他主题。