API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.queryproductinfo.query 查询商品信息
¥免费

查询商品信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custnumStringY777777操作用户id
appliCodeStringY商家编码商家编码
userTypeStringY用户类型用户类型
cityIdStringY投放城市投放城市
supplierTypeStringN1商家类型
productNumStringY商品编码商品编码
promotionTypeStringN计划类型计划类型
响应参数
名称 类型 示例值 描述
statusString0:成功,1:失败状态
msgString成功状态说明
dataString
firstPageCodeString"457529"一级类目
secondPageCodeString"457757"二级类目
thirdPageCodeString三级类目"457763"
brandIdString"0001500AH"品牌ID
brandNameString"野玫瑰"品牌名称
categoryCodeString"R6151001"分类编码
catentryIdString分类ID分类ID
catentryNameString"C非文化通子码商品数据20181223152718yccm 黃色 S"分类名称
descString"卖点卖点"描述
goodsCodeString"10160302528"商品编码
goodsFirstPictureUrlStringhttp://uimgxgpre.cnsuning.com/uimg/b2c/newcatentries/0070060496-000000010160302528_1.jpg_200w_200h“”
goodsNameString"C非文化通子码商品数据20181223152718yccm 黃色 S"商品名称
lastCatagoryIdString"457763""457763"
partNumberString"000000010160302528""000000010160302528"
priceUrlStringhttp://price1.suning.cn/webapp/wcs/stores/prdprice/10160302528_9173_0070060496_9-1.png“”
publishedString"1""1"
returnCodeString默认返回 "0"默认返回 "0"
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryQueryproductinfo>
      <promotionType>计划类型</promotionType>
      <appliCode>商家编码</appliCode>
      <custnum>777777</custnum>
      <userType>用户类型</userType>
      <cityId>投放城市</cityId>
      <productNum>商品编码</productNum>
      <supplierType>1</supplierType>
    </queryQueryproductinfo>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryQueryproductinfo": {
        "promotionType": "计划类型",
        "appliCode": "商家编码",
        "custnum": "777777",
        "userType": "用户类型",
        "cityId": "投放城市",
        "productNum": "商品编码",
        "supplierType": "1"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryQueryproductinfo>
      <msg>成功</msg>
      <data>
        <brandName>"野玫瑰"</brandName>
        <catentryId>分类ID</catentryId>
        <categoryCode>"R6151001"</categoryCode>
        <catentryName>"C非文化通子码商品数据20181223152718yccm 黃色 S"</catentryName>
        <published>"1"</published>
        <goodsFirstPictureUrl>http://uimgxgpre.cnsuning.com/uimg/b2c/newcatentries/0070060496-000000010160302528_1.jpg_200w_200h</goodsFirstPictureUrl>
        <lastCatagoryId>"457763"</lastCatagoryId>
        <returnCode>默认返回 "0"</returnCode>
        <secondPageCode>"457757"</secondPageCode>
        <thirdPageCode>三级类目</thirdPageCode>
        <brandId>"0001500AH"</brandId>
        <firstPageCode>"457529"</firstPageCode>
        <partNumber>"000000010160302528"</partNumber>
        <goodsCode>"10160302528"</goodsCode>
        <goodsName>"C非文化通子码商品数据20181223152718yccm 黃色 S"</goodsName>
        <desc>"卖点卖点"</desc>
        <priceUrl>http://price1.suning.cn/webapp/wcs/stores/prdprice/10160302528_9173_0070060496_9-1.png</priceUrl>
      </data>
      <status>0:成功,1:失败</status>
    </queryQueryproductinfo>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryQueryproductinfo": {
        "msg": "成功",
        "data": [
          {
            "brandName": "\"野玫瑰\"",
            "catentryId": "分类ID",
            "categoryCode": "\"R6151001\"",
            "catentryName": "\"C非文化通子码商品数据20181223152718yccm 黃色 S\"",
            "published": "\"1\"",
            "goodsFirstPictureUrl": "http://uimgxgpre.cnsuning.com/uimg/b2c/newcatentries/0070060496-000000010160302528_1.jpg_200w_200h",
            "lastCatagoryId": "\"457763\"",
            "returnCode": "默认返回 \"0\"",
            "secondPageCode": "\"457757\"",
            "thirdPageCode": "三级类目",
            "brandId": "\"0001500AH\"",
            "firstPageCode": "\"457529\"",
            "partNumber": "\"000000010160302528\"",
            "goodsCode": "\"10160302528\"",
            "goodsName": "\"C非文化通子码商品数据20181223152718yccm 黃色 S\"",
            "desc": "\"卖点卖点\"",
            "priceUrl": "http://price1.suning.cn/webapp/wcs/stores/prdprice/10160302528_9173_0070060496_9-1.png"
          }
        ],
        "status": "0:成功,1:失败"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.advertise.queryqueryproductinfo.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.adss 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ