查询站内装备商品 – PlayerAuctions 帮助中心

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

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

一、请求示例

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

二、请求参数

查询参数（Query Parameters）

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

三、响应示例

成功响应

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "count": 56,
    "items": [
      {
        "offerId": 71394133,
        "offerTitle": "Rare Mount - Instant Delivery",
        "sellerName": "BestSeller02",
        "sellerLevel": 4,
        "sellerRating": 4.76,
        "price": 8.99,
        "deliveryTime": "24 Hours",
        "categoryServer": "EU",
        "categoryFaction": "Horde",
        "minUnitPerOrder": 1,
        "perUnit": 1,
        "itemName": "Rare Mount",
        "discounts": [
          {
            "startPrice": 100,
            "endPrice": 499,
            "discountRate": 5
          }
        ]
      }
    ]
  }
}

错误响应

{
  "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	承诺发货时间，例如 `24 Hours`。
└─ categoryServer	string	商品所属服务器名称。商品无服务器时为 null。
└─ categoryFaction	string	商品所属阵营名称。商品无阵营时为 null。
└─ minUnitPerOrder	decimal	单笔订单最小购买数量。
└─ perUnit	decimal	每单位包含的物品数量。
└─ itemName	string	物品名称。商品无物品时为 null。
└─ discounts	array	阶梯折扣规则，按起始价格升序排列。商品无折扣时为空数组。
└─ └─ startPrice	decimal	折扣阶梯的起始价格。
└─ └─ endPrice	decimal	折扣阶梯的结束价格。
└─ └─ discountRate	decimal	折扣比例（百分比）。