跳转到主要内容
要查看您账户中的历史礼品卡购买和虚拟卡,请使用 getUserPurchases 查询。该查询需要 LIST_PURCHASES scope。此查询的响应可能较大,因此我们要求您提供分页输入,以及可选的筛选输入:

拉取购买历史

您可以使用以下查询来查看您的交易。
  1. getUserPurchases — 获取用户购买记录

分页输入

OffsetInput 参数用于管理 API 响应的分页,允许您控制每页返回的项目数量,以及从列表开头应跳过多少项目。

字段

limit (Int):此字段指定每页返回的项目数量。每页最多可请求 20 个项目。如果未指定 limit 的值,则默认为 20。 offset (Int):此字段指定在开始返回项目之前要跳过的项目数量。如果未指定 offset 的值,则默认为 0,表示从列表中的第一个项目开始。

筛选输入

UserPurchaseFilterInput 参数用于筛选响应中返回的购买记录。它允许您检索与您的应用关联的用户所做的购买,或与您的应用关联的账户下所做的购买等。它是可选的。如果未提供,响应将返回与您的应用关联的用户在所有账户中的购买记录。

字段

scope (由 PurchaseScopeFilter 组成的数组):此字段指定要使用的筛选类型。
PurchaseScopeFilter 枚举
  • TOKEN_USER:基于 userId 筛选
  • TOKEN_ACCOUNT:基于 accountId 筛选

示例

响应

当您运行此查询时,它将返回一个数组,其中包含您的历史礼品卡购买和生成的虚拟卡。

UserPurchase 对象中的字段