跳转到主要内容
通过请求 ID 跟踪抽卡和回购
  • 抽卡。 POST /v2/gacha/pull/request 受理请求后返回 HTTP 202 和 requestId。连接关闭后,抽卡仍会继续。使用 GET /v2/gacha/pull/status 查询进度。
  • 回购。 每次调用 POST /v2/gacha/buyback/request 都会生成一个独立请求。请求结束后,GET /v2/gacha/buyback/status 返回 COMPLETED 或 FAILED。
  • 流式抽卡。 POST /v2/gacha/pull/stream 的 pull_started 事件现在会返回 requestId。
  • 重试。 付款尚未确认时,重发同一份已签名的抽卡请求,状态会保持为 PENDING_PAYMENT。
修复钱包活动查询
钱包筛选参数更名,新增回购加成明细
  • 代币筛选。 钱包藏品接口将参数 tokenId 更名为 tokenIds。继续使用 tokenId 会收到 HTTP 400 和错误码 WRONG_REQUEST_PARAMS。
  • 回购加成明细。 GET /v2/gacha/draw-status 的抽卡结果和事件流的 draws_resolved 事件新增 buybackBonus,返回加成前的价值,并通过 bonusBps 给出加成比例。钱包活动、卡包公开抽卡记录以及回购期内的钱包藏品也提供此字段。
  • 回购金额已含加成。 如果卡牌有加成,返回的基础价值(buybackBaseValueInUSD 或 buybackBaseValueInUsd)和 buybackTiers 各档金额均已包含加成。GET /v2/gacha/buyback/offers 返回的各档报价也已包含加成,可直接使用。回购价值与加成
按代币 ID 筛选钱包藏品