查询装备分类 – PlayerAuctions 帮助中心

GEThttps://seller-api.playerauctions.com/api/v1/games/{id}/items/categories

查询特定游戏的装备分类。

i. 请求参数

路径参数

参数	类型	必填	描述
id	int	是	游戏ID。

ii. 响应示例

成功响应

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": [
    {
      "id": 290,
      "productType": "Items",
      "name": "Money",
      "seoName": "Money",
      "parentId": 0,
      "itemSuffix": "",
      "sequence": 0,
      "subCategorys": [
        {
          "id": 1243,
          "productType": "SubItems",
          "name": "dolla",
          "seoName": "dolla",
          "parentId": 290,
          "itemSuffix": "K",
          "sequence": 0,
          "subCategorys": []
        },
        {
          "id": 1713,
          "productType": "SubItems",
          "name": "skill-05",
          "seoName": "skill-05",
          "parentId": 290,
          "itemSuffix": "",
          "sequence": 0,
          "subCategorys": []
        }
      ]
    }
  ]
}

响应参数

参数	类型	描述
code	int	响应代码。10000 表示成功, 其它值为报错。
message	string	报错详情。
requestId	string	请求标识号，用以追溯。
data	array	类列表。每个分类包含以下字段： id (int): 分类 ID。 productType (string): 产品类型，例如 "Items"（道具）、"SubItems"（子类道具）。 name (string): 分类名称。 seoName (string): SEO 名称。 parentId (int): 父级分类 ID，0表示顶级分类（无父级）。 itemSuffix (string): 该分类下产品品的后缀（例如： ”K“， ”M“）。 sequence (int): 显示顺序 / 排序序号。 subCategorys (array): 子分类列表，结构与父级分类相同（树形嵌套结构）。

iii. 报错示例

响应报错

{
  "code": 10002,
  "message": "Game not found.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

常见报错代码

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