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

网盟业务

会员API
联盟订单API
大聚惠API
联盟商品API
招商推广活动API
获取推广链接API
优惠券推广API
机构推客API
店铺API
异常码自查工具
suning.netalliance.thirdpartyproduct.query 第三方联盟链接添加推广商品接口
￥免费

给抖音提供的通过URL查询联盟商品信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
detailUrlStringYhttps://product.suning.com/0000000000/11222350513.html商详页链接
statParamStringYA555子会员编码(不能含= &这个两个符号)
pidStringN11
响应参数
名称 类型 示例值 描述
productIdString0000000000000000011222350513商详页唯一标示10位店铺编码和18位商品编码
coverStringhttp://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e商品主图
imagesStringhttp://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e,http://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e商品轮播图可多张， 逗号分割
stockNumString0库存表示是否可售0代表可以，1代表不可售
titleString华为/荣耀（honor）9X 6+64G 魅海蓝 移动联通电信4G全网通 麒麟810 4000mAh超强续航 4800万超清夜拍 6.59英寸升降全面屏手机标题
marketPriceString159900原价(单位:分)
priceString149900售价(单位:分)
cosRatioString10佣金率
categoryString手机/数码/配件,手机通讯,手机各级类目名字，逗号 分割从一级开始拼
shortUrlStringhttps://sugs.suning.com/BOY9MJPPcps转链链接
shopNameString荣耀苏宁自营旗舰店店铺名称
shopIdString0000000000店铺唯一标示(id)
salesString500030天销量
isselfString0是否自营0表示是自营1表示不是自营
spPageUrlStringpages/fourth/fourth?productId=761187907&shop=0000000000&union=BVBP6BFE小程序卡片地址
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <queryThirdpartyproduct>
      <statParam>A555</statParam>
      <pid>1</pid>
      <detailUrl>https://product.suning.com/0000000000/11222350513.html</detailUrl>
    </queryThirdpartyproduct>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryThirdpartyproduct": {
        "statParam": "A555",
        "pid": "1",
        "detailUrl": "https://product.suning.com/0000000000/11222350513.html"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <queryThirdpartyproduct>
      <isself>0</isself>
      <images>http://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e,http://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e</images>
      <marketPrice>159900</marketPrice>
      <productId>0000000000000000011222350513</productId>
      <shortUrl>https://sugs.suning.com/BOY9MJPP</shortUrl>
      <shopName>荣耀苏宁自营旗舰店</shopName>
      <title>华为/荣耀（honor）9X 6+64G 魅海蓝 移动联通电信4G全网通 麒麟810 4000mAh超强续航 4800万超清夜拍 6.59英寸升降全面屏手机</title>
      <sales>5000</sales>
      <cover>http://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e</cover>
      <cosRatio>10</cosRatio>
      <price>149900</price>
      <spPageUrl>pages/fourth/fourth?productId=761187907&amp;shop=0000000000&amp;union=BVBP6BFE</spPageUrl>
      <stockNum>0</stockNum>
      <shopId>0000000000</shopId>
      <category>手机/数码/配件,手机通讯,手机</category>
    </queryThirdpartyproduct>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryThirdpartyproduct": {
        "isself": "0",
        "images": "http://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e,http://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e",
        "marketPrice": "159900",
        "productId": "0000000000000000011222350513",
        "shortUrl": "https://sugs.suning.com/BOY9MJPP",
        "shopName": "荣耀苏宁自营旗舰店",
        "title": "华为/荣耀（honor）9X 6+64G 魅海蓝 移动联通电信4G全网通 麒麟810 4000mAh超强续航 4800万超清夜拍 6.59英寸升降全面屏手机",
        "sales": "5000",
        "cover": "http://imgservice.suning.cn/uimg1/b2c/atmosphere/y_woLxCG6a8vvDId786rMQ.jpg_800w_800h_4e",
        "cosRatio": "10",
        "price": "149900",
        "spPageUrl": "pages/fourth/fourth?productId=761187907&shop=0000000000&union=BVBP6BFE",
        "stockNum": "0",
        "shopId": "0000000000",
        "category": "手机/数码/配件,手机通讯,手机"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.netalliance.querythirdpartyproduct.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.netalliance.querythirdpartyproduct.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.suis 服务不可用 请联系苏宁技术人员
biz.netalliance.querythirdpartyproduct.invalid-biz:100 该会员不是联盟会员 请去联盟前台申请联盟会员
biz.netalliance.querythirdpartyproduct.invalid-biz:101 该链接商品未参加 该链接商品未参加推广
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ