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

4PS业务

4PS接单管理API
4PS任务作业API
4PS仓库管理API
4ps仓库库存
4PS商品管理API
异常码自查工具
suning.fourps.categorymasdata.query 类目主数据查询接口
￥免费

通过此接口可查询商品类目主数据。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
categoryName String Y 华为 目录名称。苏宁采购目录名称。可输入中文，根据输入的信息进行关键字模糊查询。。
pageNo String N 1 页码。页码。取值范围:大于零的整数;默认值为1，即返回第一页数据。
pageSize String N 2 条数。每页条数。取值范围:大于零的整数;最大值：50。默认值：10。
响应参数
名称 类型 示例值 描述
categoryName String 服饰鞋帽 商品目录名称。
categoryCode String R3301002 商品目录编码。
grade String 4 当前目录层级。
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
	<sn_body>
		<queryCategoryMasData>
			<categoryName>生活日用家庭清洁</categoryName>
			<pageNo>1</pageNo>
			<pageSize>2</pageSize>
		</queryCategoryMasData>
	</sn_body>
</sn_request>
			
                                
                                
{
	"sn_request": {
		"sn_body": {
			"queryCategoryMasData": {
				"categoryName": "生活日用家庭清洁",
				"pageNo": "1",
				"pageSize": "2"
			}
		}
	}
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
	<sn_head>
		<pageTotal>2</pageTotal>
		<pageNo>1</pageNo>
		<totalSize>3</totalSize>
		<returnMessage>biz.handler.data-get:success</returnMessage>
	</sn_head>
	<sn_body>
		<queryCategoryMasData>
			<categoryName>服饰鞋帽</categoryName>
			<categoryCode>1</categoryCode>
			<grade>2</grade>
		</queryCategoryMasData>
		<queryCategoryMasData>
			<categoryName>服饰鞋帽</categoryName>
			<categoryCode>1</categoryCode>
			<grade>2</grade>
		</queryCategoryMasData>
	</sn_body>
</sn_responseContent>
			
                              
                              
{
	"sn_responseContent": {
		"sn_head": {
			"pageTotal": "2",
			"pageNo": "1",
			"totalSize": "3",
			"returnMessage": "biz.handler.data-get:success"
		},
		"sn_body": {
			"queryCategoryMasData": [
				{
					"categoryName": "服饰鞋帽",
					"categoryCode": "1",
					"grade": "2"
				},
				{
					"categoryName": "服饰鞋帽",
					"categoryCode": "1",
					"grade": "2"
				}
			]
		}
	}
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.fourps.querycategorymasdata.missing-parameter:* 请求参数为空 请输入正确参数。
biz.handler.data-get:no-result 查询无结果 请输入正确参数。
isp.sys.service.unavailable.fpscp 服务不可用（系统异常） 请联系苏宁技术人员。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：类目主数据查询接口接口如何使用？

A：通过此接口可查询商品类目主数据。