设置商品展示状态 – PlayerAuctions 帮助中心

POST https://seller-api.playerauctions.com/api/v1/offers/display-status

按指定条件显示/隐藏部分或全部商品。

i. 请求示例

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

ii. 请求参数

请求体参数

参数	类型	必填	描述
offerIds	int[]	否	待上架/隐藏的商品编号。 isAll 为 false 时必填。
flag	string	是	要执行的操作。有效值：`"hide"`（隐藏）或 `"display"`（显示）。
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"
}

响应参数

参数	类型	描述
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 数组内提供需要隐藏/显示的报价单编号。
参数 flag 不区分大小写，但有效值仅限"hide"（隐藏）或 "display" （显示）。
当提供 parameters.serverId 参数时，parameters.factionId 参数将被忽略。