查询游戏服务器 – PlayerAuctions 帮助中心

GEThttps://seller-api.playerauctions.com/api/v1/games/{id}/{type}/servers

根据指定的“游戏”和“产品品类型”检索对应的游戏服务器列表。

i. 请求参数

路径参数

参数	类型	必填	描述
id	int	Yes	游戏 ID。
type	string	Yes	产品类型。可选值包括： "currency"（游戏币）、"items"（道具）、"accounts"（账号）、"powerleveling"（代练）或 "topup"（充值）。

ii. 响应示例

成功响应

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": [
    {
      "id": 9550,
      "productType": "Server",
      "name": "lisajones",
      "seoName": "lisajones",
      "parentId": 3637,
      "itemSuffix": "",
      "sequence": 0,
      "subCategorys": [
        {
          "id": 9560,
          "productType": "Faction",
          "name": "'angelabrown'",
          "seoName": "'angelabrown'",
          "parentId": 9550,
          "itemSuffix": "",
          "sequence": 0,
          "subCategorys": []
        }
      ]
    }
  ]
}

响应参数

参数	类型	描述
code	int	响应代码。10000 表示成功, 其它值为报错。
message	string	响应信息及报错详情。
requestId	string	请求标识号, 用以追溯。
data	array	指定游戏的服务器列表。
data[].subCategorys	array	服务器下的子分类列表。
data[].productType	string	服务器的产品类型。
data[].name	string	服务器的名称。
data[].seoName	string	服务器的 SEO 名称
data[].parentId	int	该分类的父级分类 ID。
data[].itemSuffix	string	该服务器的产品后缀（例如： “K", "M")。
data[].sequence	int	服务器的排序序号。
data[].subCategorys[].productType	string	该分类的商品类型。
data[].subCategorys[].name	string	该分类的名称。
data[].subCategorys[].seoName	string	该分类的 SEO 名称。
data[].subCategorys[].parentId	int	该分类的父级分类 ID。
data[].subCategorys[].itemSuffix	string	该分类的产品品后缀（例如： “K", "M")。
data[].subCategorys[].sequence	int	该分类的排序序号。

iii. 报错示例

响应报错

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

常见报错代码

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