ListCategories - 查询类目列表

查询类目列表。

接口说明

根据父类目 id 查询所有子类目信息,或者根据类目 id 查询类目信息。

当父类目 id(parentCategoryId)为 0 时,则返回根类目下的一级类目。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /opensaas-s2b/opensaas-s2b-biz-trade/v2/categories/commands/list HTTP/1.1

请求参数

名称类型必填描述示例值
bodyCategoryListQuery

类目查询参数

// 查询类目(parentCategoryId)下的所有子类目
{
  "body": {
    "parentCategoryId": "50016422"
  }
}

// 根据入参类目 id(categoryIds)批量查询类目
{
  "body": {
    "categoryIds": [
      "202007601",
      "201792301"
    ]
  }

返回参数

名称类型描述示例值
CategoryListResult

类目

{
  "requestId": "4D1FC14F-CE54-1A1F-A322-D6DC87D49AFE",
  "categories": [
    {
      "categoryId": 201792301,
      "name": "方便面/拉面/挂面/轻食面速食",
      "parentId": 50016422,
      "level": 2,
      "isLeaf": false
    },
    {
      "categoryId": 202007601,
      "name": "方便速食/速冻食品类卡券",
      "parentId": 50016422,
      "level": 2,
      "isLeaf": false
    }
  ]
}

示例

正常返回示例

JSON格式

{
  "requestId": "",
  "categories": [
    {
      "name": "名称测试",
      "isLeaf": false,
      "level": 0,
      "categoryId": 201792301,
      "parentId": 0
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史