PUThttps://seller-api.playerauctions.com/api/v1/offers/powerleveling
更新已有代练商品。
i. 请求示例
{
"offerId": 71394385,
"gameId": 3637,
"title": "Simple Title Update",
"offerDesc": "<p>Simple Title Update</p>",
"offerDuration": 30,
"agreeCheck": true,
"price": 69.98,
"totalUnit": 100,
"parentItemId": 863,
"itemId": ""
}
ii. 请求参数
请求体参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| offerId | int | 是 | 需编辑的商品ID。 |
| gameId | int | 是 | 游戏ID。 |
| price | decimal | 是 | 每份单价。 |
| offerDuration | int | 是 | 商品有效期天数。可选值: 3, 7, 14, 或30。 |
| agreeCheck | bool | 是 | 是否同意 [Secure Seller Delivery Agreement] (用户发货安全协议)。必须为true(真)。 |
| title | string | 是 | 商品标题。 |
| offerDesc | string | 否 | 商品描述。 |
| totalUnit | int | 是 | 总份数。 |
| parentItemId | int | 是 | 一级代练服务ID。 |
| itemId | int? | 否 | 二级代练服务ID。 |
iii. 响应示例
成功响应
{
"code": 10000,
"message": "",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"data": {
"offerId": 71394386,
"navigateURL": "https://www.playerauctions.com/lol-boosting/71394386p!simple-title-update/",
"title": "Simple Title Update",
"productType": "powerleveling",
"gameName": "League of Legends",
"productName": "Power leveling",
"screenShot": "",
"imageBlacklist": ""
}
}
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| code | int | 响应状态码。 10000表示成功,其他值表示发生错误。 |
| message | string | 响应消息。 当请求失败时,该字段会包含具体的错误详情。 |
| requestId | string | 请求标识号,用以追溯。 |
| data | object | 更新后的商品信息。 |
| offerId | int | 更新后的商品 ID。 |
| navigateURL | string | 更新后的商品链接。 |
| title | string | 商品标题。 |
| productType | string | 商品类型。此端口为“Powerleveling". |
| gameName | string | 游戏名称。 |
| productName | string | 商品名称。 |
| screenShot | string | 商品截图链接。无截图为空。 |
| imageBlacklist | string | 商品图片黑名单标识。该字段为空表示未加入黑名单。 |
iv. 报错示例
响应报错
{
"code": 10002,
"message": "Invalid parameter.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}常见报错代码
| 参数 | 类型 | 描述 |
|---|---|---|
| code | int | 报错代码。 常见值: 10002 (无效参数), 50001 (服务器内部错误)。 |
| message | string | 报错详情。 |
| requestId | string | 请求标识号,用以追溯。 |