查询站内充值商品 – PlayerAuctions 帮助中心

Gethttps://seller-api.playerauctions.com/api/v1/olp/topup

获取指定游戏的已发布充值商品分页列表。结果按商品 ID 降序排列（最新的在前）。

一、请求示例

https://seller-api.playerauctions.com/api/v1/olp/topup?gameId=9479&pageIndex=1&pageSize=20&categoryId=&serverId=

二、请求参数

查询参数（Query Parameters）

参数	类型	是否必填	说明
gameId	int	是	游戏 ID。
pageIndex	int	否	页码。默认值：1。小于 1 的值将被视为 1。
pageSize	int	否	每页返回条数。默认值：20。最大值：100。
categoryId	int	否	按充值分类 ID 筛选。
serverId	int	否	按服务器 ID 筛选。可通过 api/v1/games/{id}/{type}/servers 接口获取服务器的树形结构数据。未分类的商品始终会被包含在结果中。

三、响应示例

成功响应

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "count": 24,
    "items": [
      {
        "offerId": 71394136,
        "offerTitle": "500 Gems Top Up - Instant",
        "sellerName": "BestSeller05",
        "sellerLevel": 5,
        "sellerRating": 4.95,
        "price": 9.99,
        "deliveryTime": "In 20 Minutes",
        "categoryServer": "Asia",
        "categoryFaction": "",
        "minUnitPerOrder": 1,
        "perUnit": "500+50",
        "categoryName": "Gems"
      }
    ]
  }
}

错误响应

{
  "code": 10002,
  "message": "Invalid parameter.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

四、响应参数

参数	类型	说明
code	int	响应码。10000 表示成功；其他值表示请求出错。
message	string	响应消息。请求失败时包含错误详情。
requestId	string	请求唯一标识，用于问题追踪。
data	object	响应数据主体。仅在请求成功时返回。
data.count	int	符合筛选条件的商品总数。
data.items	array	当前页的商品列表。
└─ offerId	int	商品 ID。
└─ offerTitle	string	商品标题。
└─ sellerName	string	卖家名称。
└─ sellerLevel	int	卖家等级。
└─ sellerRating	decimal	卖家加权评分。
└─ price	decimal	单价（美元）。
└─ deliveryTime	string	承诺发货时间，例如 `In 20 Minutes`。
└─ categoryServer	string	商品所属服务器名称。商品无服务器时为 null。
└─ categoryFaction	string	商品所属阵营名称。商品无阵营时为 null。
└─ minUnitPerOrder	decimal	单笔订单最小购买数量。
└─ perUnit	string	每单位包含的数量。对于固定数量的分类，格式为 `{fixedQuantity}+{extraQuantity}`，例如 `500+50`。商品无分类时为 null。
└─ categoryName	string	充值分类名称。商品无分类时为 null。