API 参考 / market-snapshots

搜索公开市场游戏库

GET /api/v1/market-games · searchMarketGames

按名称与平台搜索已归一的公共游戏实体，供 Survey v2 选择竞品。只返回 public_market 来源和来源标识，不返回组织私有数据。手动竞品不会因此被伪装成已匹配游戏。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

q: string
platform: string
limit: integer

响应字段 · 200

items（必填）: MarketGame[]
items[].id（必填）: string
items[].name（必填）: string
items[].aliases（必填）: string[]
items[].platforms（必填）: MarketPlatform[]
items[].sourceRefs（必填）: MarketGameSourceRef[]
items[].sourceRefs[].source（必填）: string
items[].sourceRefs[].platform（必填）: enum；取值：steam / taptap / apple / wechat_minigame
items[].sourceRefs[].sourceId（必填）: string
items[].sourceRefs[].sourceUrl: string
items[].updatedAt（必填）: string

错误

401：Problem 错误响应
422：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/market-games?q=…&platform=…" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "name": "示例标题",
      "aliases": [
        "示例文本"
      ],
      "platforms": [
        "steam"
      ],
      "sourceRefs": [
        {}
      ],
      "updatedAt": "2026-08-01"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引