API接口目录

网盟业务

会员API
联盟订单API
大聚惠API
联盟商品API
招商推广活动API
获取推广链接API
优惠券推广API
机构推客API
店铺API
异常码自查工具
suning.netalliance.merchantcommodity.query 获取招商活动的商品
¥免费

获取招商活动的商品

公共参数
请求参数
名称 类型 是否必须 示例值 描述
activityIdStringY123活动id
adBookIdStringY100025推广位id
pageNoStringN1页码
pageSizeStringN10每页条数
响应参数
名称 类型 示例值 描述
merchantCommodityString
commCodeString150014339商品编码
commNameString笔记本电池商品名称
firstCategoryCodeString电脑商品一级类目
mertCodeString0000000000商家编码(如果为自营,默认十个0)
mertNameString自营商家名称(如果为自营,默认“自营”)
payPriceString3999.00易购价
pcExtendUrlStringhttps%3a%2f%2fsucs.suning.com%2fvisitor.htm%3fuserId%3d101192598%26...PC推广链接(获取到链接后,需进行URL解码才可推广;如果需要加入子会员id,解码后的链接中增加字段SubUserEx)
prePayCommissionString39.00预估佣金
prodPicUrlStringhttp://image2.suning.cn/uimg/b2c/newcatentries/0070062522-000000000109324634_3_100x100.jpg商品图片URL(多图使用英文逗号分隔)
rateString0.125佣金比例
storeTypeString1C店自营商品标识(1=自营 2=C店)
wapExtendUrlStringhttps%3a%2f%2fsucs.suning.com%2fvisitor.htm%3fuserId%3d101192598%26...wap推广链接(获取到链接后,需进行URL解码才可推广;如果需要加入子会员id,解码后的链接中增加字段SubUserEx)
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryMerchantcommodity>
      <activityId>123</activityId>
      <adBookId>100025</adBookId>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
    </queryMerchantcommodity>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryMerchantcommodity": {
        "activityId": "123",
        "adBookId": "100025",
        "pageNo": "1",
        "pageSize": "10"
      }
    }
  }
}
                                
响应示例
  • 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>
    <queryMerchantcommodity>
      <merchantCommodity>
        <mertName>自营</mertName>
        <commCode>150014339</commCode>
        <storeType>1</storeType>
        <prePayCommission>39.00</prePayCommission>
        <rate>0.125</rate>
        <payPrice>3999.00</payPrice>
        <mertCode>0000000000</mertCode>
        <firstCategoryCode>电脑</firstCategoryCode>
        <commName>笔记本电池</commName>
        <prodPicUrl>http://image2.suning.cn/uimg/b2c/newcatentries/0070062522-000000000109324634_3_100x100.jpg</prodPicUrl>
        <wapExtendUrl>https%3a%2f%2fsucs.suning.com%2fvisitor.htm%3fuserId%3d101192598%26...</wapExtendUrl>
        <pcExtendUrl>https%3a%2f%2fsucs.suning.com%2fvisitor.htm%3fuserId%3d101192598%26...</pcExtendUrl>
      </merchantCommodity>
    </queryMerchantcommodity>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryMerchantcommodity": {
        "merchantCommodity": [
          {
            "mertName": "自营",
            "commCode": "150014339",
            "storeType": "1",
            "prePayCommission": "39.00",
            "rate": "0.125",
            "payPrice": "3999.00",
            "mertCode": "0000000000",
            "firstCategoryCode": "电脑",
            "commName": "笔记本电池",
            "prodPicUrl": "http://image2.suning.cn/uimg/b2c/newcatentries/0070062522-000000000109324634_3_100x100.jpg",
            "wapExtendUrl": "https%3a%2f%2fsucs.suning.com%2fvisitor.htm%3fuserId%3d101192598%26...",
            "pcExtendUrl": "https%3a%2f%2fsucs.suning.com%2fvisitor.htm%3fuserId%3d101192598%26..."
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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