官方分类

获取电商平台店铺的官方分类树，支持 1688 与 微店（weidian 须传 shop_id）。

GEThttps://open.hiobuy.com/api/client/open-purchase/category/item

若实际 API 基地址不同，请替换 `https://open.hiobuy.com`。

请求头

名称必填类型说明
X-Uuid是string商户 UUID（账户唯一标识）

查询参数

名称必填类型说明
platform是string平台：`taobao`（淘宝）、`1688`、`weidian`（微店）
shop_id否string店铺 ID。`platform` 为 `weidian` 时**必填**
categoryId否string父分类 ID，用于加载子分类；不传则返回完整分类树

请求示例

GET /api/client/open-purchase/category/item?platform=1688

微店示例：

GET /api/client/open-purchase/category/item?platform=weidian&shop_id=YOUR_SHOP_ID

响应示例

{
  "ret": 1,
  "msg": "操作成功",
  "data": [
    {
      "id": 0,
      "name": "未分类",
      "children": []
    },
    {
      "id": 153155016,
      "name": "女装",
      "children": [
        {
          "id": 153155017,
          "name": "睡衣"
        },
        {
          "id": 153155049,
          "name": "打底裤"
        }
      ]
    },
    {
      "id": 153156429,
      "name": "男装",
      "children": [
        {
          "id": 153156430,
          "name": "羽绒服"
        },
        {
          "id": 153191807,
          "name": "T恤"
        }
      ]
    }
  ]
}
实际 `data` 分类列表可能很长，下例仅展示部分节点。

响应字段

顶层字段

名称类型说明
retnumber状态码，`1` 表示成功
msgstring状态说明
dataobject官方分类树

data[]

名称类型说明
idnumber分类 ID，`0` 表示未分类
namestring分类显示名称
childrenarray子分类列表；无子级时为空数组

data[].children[]

名称类型说明
idnumber子分类 ID
namestring子分类名称

相关接口