商品列表 – PlayerAuctions 帮助中心

GEThttps://seller-api.playerauctions.com/api/v1/offers

检索商品列表。

i. 请求参数

查询参数

参数	类型	必填	描述
keyword	string	否	按商品标题模糊搜索。
listingStatus	string	否	按商品状态筛选 [如 "active"(显示), "hidden"(隐藏), "closed"(已关闭) ]。默认值: "active"(显示)。
productType	string	否	按产品类别筛选 [如, "all" (全部), "currency" (货币), "items" (装备), "accounts" (账号), "powerleveling" (代练), "topup" (充值) ]. 默认: "all" (全部)。
serverId	int?	否	按服务器筛选。
factionId	int?	否	按阵营筛选。如已提供服务器，忽略该参数。
gameId	int?	否	按游戏筛选。
pageIndex	int?	否	按分页页码筛选。
pageSize	int?	否	分页规格。

ii. 响应示例

成功响应

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "hideOfferWarning": "",
    "count": 1,
    "items": [
      {
        "offerId": 71394124,
        "systemStatus": "Active",
        "offerStatus": "Active",
        "title": "Divine Orb Runes of Aldur Standard",
        "gameName": "Path of Exile 2",
        "deliveryGuarantee": "1 Hour",
        "totalPrice": "$ 5.00",
        "expiredTimeString": "Jul-08-2026 10:35:54 PM",
        "productType": "Currency",
        "currencyPerUnit": 100.0,
        "everyGold": "20",
        "suffix": "",
        "name": "Currency",
        "itemNameEn": "",
        "url": "https://www.playerauctions.com/path-of-exile-2-currency/71394124c!divine-orb-runes-of-aldur-standard/",
        "topUpFixQuantity": 0,
        "topUpExtraQuantity": 0,
        "topUpCategoryName": "V-Bucks"
      }
    ]
  }
}

响应参数

参数	类型	描述
code	int	响应代码。10000 表示成功, 其它值为报错。
message	string	响应信息及报错详情。
requestId	string	请求标识号, 用以追溯。
data	object	商品列表。
data.hideOfferWarning	string	对active (上架)状态的商品返空字串; 反之返回商品隐藏原因。
data.count	int	检索结果总数。
data.items	object[]	商品列表。
data.items[].offerId	int	商品编号。
data.items[].systemStatus	string	商品系统状态。
data.items[].offerStatus	string	商品显示状态。 [如., "active"(上架), "hidden"(隐藏), "closed"(已下架) ]。
data.items[].title	string	商品标题。
data.items[].gameName	string	游戏名称。
data.items[].deliveryGuarantee	string	发货期限。
data.items[].totalPrice	string	总价。
data.items[].expiredTimeString	string	有效期字串
data.items[].productType	string	产品类别 [如, "currency" (货币), "items" (装备), "accounts" (账号), "powerleveling" (代练), "topup" (充值) ]。
data.items[].currencyPerUnit	double	每份货币数量。仅限货币类商品。
data.items[].everyGold	string	每1美金可购货币数量。仅限货币类商品。
data.items[].suffix	string	货币数量单位 (如 “K”, “M”)。仅限货币类商品。
data.items[].name	string	货币名称。仅限货币类商品。
data.items[].itemNameEn	string	自定义道具名。仅限装备类商品。
data.items[].url	string	商品链接。
data.items[].topUpFixQuantity	int	定额充值数量。 (仅限充值类商品)
data.items[].topUpExtraQuantity	int	附赠充值数量。 (仅限充值类商品)
data.items[].topUpCategoryName	string	充值代币名称。 (仅限充值类商品)

iii. 报错示例

响应报错

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

常见报错代码

参数	类型	描述
code	int	报错代码。常见值: 10002 (无效参数), 50001 (服务器内部错误)。
message	string	报错详情。
requestId	string	请求标识号，用以追溯。