Gethttps://seller-api.playerauctions.com/api/v1/olp/boosting
获取指定游戏的已发布代练商品分页列表。结果按商品 ID 降序排列(最新的在前)。
一、请求示例
https://seller-api.playerauctions.com/api/v1/olp/boosting?gameId=9479&pageIndex=1&pageSize=20&itemId=二、请求参数
查询参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| gameId | int | 是 | 游戏 ID。 |
| pageIndex | int | 否 | 页码。 默认值:1。小于 1 的值将被视为 1。 |
| pageSize | int | 否 | 每页返回条数。 默认值:20。最大值:100。 |
| itemId | int | 否 | 按代练分类 ID 筛选。返回该分类及其子分类下的商品。 |
三、响应示例
成功响应
{
"code": 10000,
"message": "",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"data": {
"count": 18,
"items": [
{
"offerId": 71394135,
"offerTitle": "Level 1 to 60 Power Leveling",
"sellerName": "BestSeller04",
"sellerLevel": 5,
"sellerRating": 4.88,
"price": 45.00,
"itemParentName": "Power Leveling",
"itemName": "Leveling"
}
]
}
}错误响应
{
"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 | 单价(美元)。 |
| └─ itemParentName | string | 上级代练分类名称。分类无上级时为 null。 |
| └─ itemName | string | 代练分类名称。商品无分类时为 null。 |