取消资格校验 – PlayerAuctions 帮助中心

Posthttps://seller-api.playerauctions.com/api/v1/offers/cancellation-eligibility

检查商品是否符合下架条件。

i. 请求示例

{
  "offerIds": [1001, 1002],
  "isAll": false,
  "parameters": {
    "keywords": "gold",
    "listingStatus": "active",
    "productType": "currency",
    "gameId": 1,
    "serverId": 10,
    "factionId": 5
  }
}

ii. 请求参数

请求体参数

参数	类型	必填	描述
offerIds	int[]	否	待检查的商品编号。 `isAll` 为 `false` 时必填。
isAll	boolean	是	是否检查符合筛选条件的全部商品。设置为 `true` 时，无需传入 `offerIds`。
parameters	object	否	筛选参数。当 `isAll` 为 `true` 时，用于选择需检查的商品。
parameters.keywords	string	否	按关键词筛选。
parameters.listingStatus	string	否	按商品状态筛选 [如 "active"(上架), "hidden"(隐藏), "closed"(已下架) ]。
parameters.productType	string	否	按产品类别筛选 [如, "currency" (货币), "items" (装备), "accounts" (账号), "powerleveling" (代练), "topup" (充值) ].
parameters.gameId	int?	否	按游戏筛选。
parameters.serverId	int?	否	按服务器筛选。
parameters.factionId	int?	否	按阵营筛选. 如已提供服务器, 忽略该参数。

iii. 响应示例

成功响应 (JSON)

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {}
}

响应参数

参数	类型	描述
code	int	响应代码。10000 表示成功, 其它值为报错.
message	string	响应信息及报错详情。
requestId	string	请求标识号，用以追溯。

iv. 报错示例

响应报错

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

常见错误代码

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

注：

当 isAll 设置为 true ，offerIds 参数将被忽略，操作将应用于所有符合 parameters 中筛选条件的商品。
当 isAll 设置为 false ，必须在 offerIds 数组内提供需要检查的商品编号。
当提供 parameters.serverId 参数时，parameters.factionId 参数将被忽略。