退出
热词搜索：
API接口目录

苏宁有货业务

有货买家商品API
有货买家价格库存API
有货买家订单API
有货买家物流API
有货买家售后API
有货买家其他API
有货卖家商品API
家乐福供货平台API
异常码自查工具
suning.sngoods.category.query 获取商品采购目录信息
￥免费

可以通过此接口获取苏宁授权的采购目录信息。 1、 可以输入苏宁采购目录名称进行模糊查询，系统返回该商户操作权限下的采购目录名称均符合的所有采购目录信息。也可以不输入任何数据进行查询，系统返回商户操作权限下的所有采购目录信息。 2、 pageNo（页码）、pageSize（每页条数）必须组合查询，否则，系统默认返回第一页的10条数据。 3、返回结果分页展示，通过输入的页码可以定位到具体第几页，每页条数控制每页返回的条数。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
categoryNameStringN服饰鞋帽苏宁采购目录名称。可输入中文，根据输入的信息进行关键字模糊查询。
pageNoStringN1页码
pageSizeStringN10每页条数
响应参数
名称 类型 示例值 描述
categoryCodeStringR3301002当前采购目录编码。
categoryNameString工具箱当前采购目录名称。
descPathString家用视听设备及相关配件|工程音响|专业音响|专业音响采购目录层级描述
fourCategoryString
categoryCodeString四级类目编码四级类目编码
categoryNameString四级类目名称四级类目名称
descPathString家用视听设备及相关配件|工程音响|专业音响|专业音响采购目录层级描述
gradeString4当前采购目录层级。
isBottomStringX“X”表示无下级目录；“N”表示有下级目录。
gradeString4当前采购目录层级。
isBottomStringX“X”表示无下级目录；“N”表示有下级目录。
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <category>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <categoryName>服饰鞋帽</categoryName>
    </category>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "category": {
        "pageNo": "1",
        "pageSize": "10",
        "categoryName": "服饰鞋帽"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <category>
      <descPath>家用视听设备及相关配件|工程音响|专业音响|专业音响</descPath>
      <grade>4</grade>
      <categoryCode>R3301002</categoryCode>
      <fourCategory>
        <descPath>家用视听设备及相关配件|工程音响|专业音响|专业音响</descPath>
        <grade>4</grade>
        <categoryCode>四级类目编码</categoryCode>
        <categoryName>四级类目名称</categoryName>
        <isBottom>X</isBottom>
      </fourCategory>
      <categoryName>工具箱</categoryName>
      <isBottom>X</isBottom>
    </category>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "category": [
        {
          "descPath": "家用视听设备及相关配件|工程音响|专业音响|专业音响",
          "grade": "4",
          "categoryCode": "R3301002",
          "fourCategory": [
            {
              "descPath": "家用视听设备及相关配件|工程音响|专业音响|专业音响",
              "grade": "4",
              "categoryCode": "四级类目编码",
              "categoryName": "四级类目名称",
              "isBottom": "X"
            }
          ],
          "categoryName": "工具箱",
          "isBottom": "X"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.querycategory.format-error:* 格式错误,*表示字段名 请输入正确参数。
biz.custom.querycategory.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.MCMP 服务不可用（系统异常） 请联系苏宁技术人员。
biz.custom.querycategory.invalid-biz:100 线上线下标识错误 请检查线上线下标识
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ