API接口目录

网盟业务

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

商品精选接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
eliteIdStringN1默认为1,,营销id。1-小编推荐;2-实时热销榜;3-当日热推榜;4-高佣爆款榜;5-团长招商榜;6-9块9专区
pageIndexStringN1页码 默认0
cityCodeStringN025城市编码 默认025
picWidthStringN200图片宽度
picHeightStringN200图片高度
selfSupportStringN0是否苏宁自营。0:全部;1:是
sizeStringN10每页数量,最大支持40
couponMarkStringN11表示拿到券后价,不传按照以前逻辑取不到券后价
响应参数
名称 类型 示例值 描述
commodityListString
commodityInfoString
commodityNameString商品名称示例商品名称
commodityCodeString121307256商品编码
supplierCodeString0000000000供应商编码
supplierNameString供应商名称示例供应商名称
pictureUrlString
locationIdString1图片位置
picUrlStringhttps://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e图片URL
sellingPointString卖点示例卖点
monthSalesString1000月销量
snPriceString100.0易购价
commodityPriceString99.00商品价格
commodityTypeString1商品类型 1:自营 2:C店 3:海外购自营 4:海外购 5:特卖 6:极物
priceTypeString大聚惠价格类型
priceTypeCodeString1 价格类型编码 0:正常价格,1:大聚惠 , 2:抢购, 3:渠道专享, 4:限时促销 ,5:爆款抢购,6:掌上抢,7:特卖,99:乐拼购
baoyouString1是否包邮 0:不包邮 1:包邮
rateString20.00佣金比例 (数值为百分比数据)
saleStatusString1是否可售 0:可售,1:无货,2:本地暂不销售
productUrlStringhttps://product.suning.com/供应商编码/商品编码.html四级页地址
forbiddenMarkString11:禁售 0:非禁售
isActString10不是 1是
pgInfoString
pgNumString2成团人数
pgPriceString20.00拼购价
pgUrlStringhttps://pin.suning.com/pgs/product/45918238111498247256.html拼购四级页地址
pgActionIdString45918238111498247256拼购活动ID
minOrderQuantityString1拼购商品起售数量
categoryInfoString
firstSaleCategoryIdString50000一级销售目录ID
firstSaleCategoryNameString一级销售目录名称示例一级销售目录名称
secondSaleCategoryIdString50000二级销售目录ID
secondSaleCategoryNameString二级销售目录名称示例二级销售目录名称
thirdSaleCategoryIdString50000三级销售目录ID
thirdSaleCategoryNameString三级销售目录名称示例三级销售目录名称
firstPurchaseCategoryIdStringR001一级采购目录ID
firstPurchaseCategoryNameString一级采购目录名称示例一级采购目录名称
secondPurchaseCategoryIdStringR002二级采购目录ID
secondPurchaseCategoryNameString二级采购目录名称示例二级采购目录名称
thirdPurchaseCategoryIdStringR003三级采购目录ID
thirdPurchaseCategoryNameString三级采购目录名称示例三级采购目录名称
goodsGroupCategoryIdStringR9001213商品组目录ID
goodsGroupCategoryNameString商品组目录名称示例商品组目录名称
couponInfoString
couponUrlString https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM券链接URL
activityIdString201907040010040371券活动编码
activitySecretKeyStringmzekhfSGwaRrZIopV0M1wGRM券秘钥
couponValueString10.00券面额
couponCountString1000券总数
couponStartTimeString2019-07-04 17:10:47券领取开始时间
couponEndTimeString2019-07-04 17:10:47券领取结束时间
startTimeString2019-07-04 17:10:47券使用开始时间
endTimeString2019-07-04 17:10:47券使用结束时间
bounsLimitString15.00基数数值
activityDescriptionString免费领取送券10元活动描述
afterCouponPriceString60.00券后价
preferentialDistinctString奖励优惠说明奖励优惠说明
couponShowTypeString1券标识类型,1.金额券 2,打折券
descriptionForListString列表页券描述列表页券描述
bounsAmountString1奖励数值(券面额)
advanceSaleString
isReserveCommodityString1是否预售 1:是 0:否
depositAmountString20定金
depositEndTimeString2017-10-10 10:00:00付定金结束时间
isHaveDataString11:下一页有值 0:下一页无值
orderActivityString
activityRuleListString
floorString1层级
baseAmountString2基数数值
rewardAmountString0.2奖励数值
activityDescriptionString满2件打8折奖励描述
cmmdtyReviewInfoString
totalReviewCountString123评价总数
goodReviewCountString123好评数量
goodRateString12好评率
subCodeListString
subCodeString123子码
parametersListString
parameterCodeString1参数代码
parameterSequenceString1参数排序码
parameterDescString1参数描述
parameterValString1参数描述值
parametersCodeString1参数组代码
parametersDescString1参数组描述
sequenceString1参数组排序
explainString说明参数说明文
coreFlagString1核心参数
arrivalPriceString1到手价
couponInfoListString
startTimeString2021-05-06 11:41:39开始时间
activityIdString202105060010204429活动id
couponStartTimeString2021-05-06 11:41:37券开始时间
bounsLimitString2使用条件
activityDescriptionString活动描述活动描述
couponEndTimeString2021-11-02 11:41:37券结束时间
couponCountString999券总数
couponValueString1券面额
endTimeString2021-11-02 11:41:37结束时间
activitySecretKeyStringllOAnJF1OmD2nlgtjtkBwj2l活动密钥
couponUrlStringhttp://quanpre.cnsuning.com/lqzx_recommend.do?activityId=202105060010204429&activitySecretKey=llOAnJF1OmD2nlgtjtkBwj2l券链接
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <querySelectrecommendcommodity>
      <eliteId>1</eliteId>
      <picWidth>200</picWidth>
      <couponMark>1</couponMark>
      <picHeight>200</picHeight>
      <selfSupport>0</selfSupport>
      <size>10</size>
      <pageIndex>1</pageIndex>
      <cityCode>025</cityCode>
    </querySelectrecommendcommodity>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "querySelectrecommendcommodity": {
        "eliteId": "1",
        "picWidth": "200",
        "couponMark": "1",
        "picHeight": "200",
        "selfSupport": "0",
        "size": "10",
        "pageIndex": "1",
        "cityCode": "025"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <querySelectrecommendcommodity>
      <commodityList>
        <advanceSale>
          <depositAmount>20</depositAmount>
          <depositEndTime>2017-10-10 10:00:00</depositEndTime>
          <isReserveCommodity>1</isReserveCommodity>
        </advanceSale>
        <subCodeList>
          <subCode>123</subCode>
        </subCodeList>
        <isHaveData>1</isHaveData>
        <couponInfo>
          <activitySecretKey>mzekhfSGwaRrZIopV0M1wGRM</activitySecretKey>
          <couponShowType>1</couponShowType>
          <afterCouponPrice>60.00</afterCouponPrice>
          <couponCount>1000</couponCount>
          <couponUrl>	https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&amp;activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM</couponUrl>
          <couponValue>10.00</couponValue>
          <bounsLimit>15.00</bounsLimit>
          <couponEndTime>2019-07-04 17:10:47</couponEndTime>
          <activityId>201907040010040371</activityId>
          <preferentialDistinct>奖励优惠说明</preferentialDistinct>
          <couponStartTime>2019-07-04 17:10:47</couponStartTime>
          <descriptionForList>列表页券描述</descriptionForList>
          <startTime>2019-07-04 17:10:47</startTime>
          <activityDescription>免费领取送券10元</activityDescription>
          <endTime>2019-07-04 17:10:47</endTime>
          <bounsAmount>1</bounsAmount>
        </couponInfo>
        <couponInfoList>
          <activitySecretKey>llOAnJF1OmD2nlgtjtkBwj2l</activitySecretKey>
          <bounsLimit>2</bounsLimit>
          <couponEndTime>2021-11-02 11:41:37</couponEndTime>
          <activityId>202105060010204429</activityId>
          <couponStartTime>2021-05-06 11:41:37</couponStartTime>
          <couponCount>999</couponCount>
          <couponUrl>http://quanpre.cnsuning.com/lqzx_recommend.do?activityId=202105060010204429&amp;activitySecretKey=llOAnJF1OmD2nlgtjtkBwj2l</couponUrl>
          <startTime>2021-05-06 11:41:39</startTime>
          <activityDescription>活动描述</activityDescription>
          <endTime>2021-11-02 11:41:37</endTime>
          <couponValue>1</couponValue>
        </couponInfoList>
        <orderActivity>
          <activityRuleList>
            <rewardAmount>0.2</rewardAmount>
            <floor>1</floor>
            <baseAmount>2</baseAmount>
          </activityRuleList>
          <activityDescription>满2件打8折</activityDescription>
        </orderActivity>
        <pgInfo>
          <pgUrl>https://pin.suning.com/pgs/product/45918238111498247256.html</pgUrl>
          <pgActionId>45918238111498247256</pgActionId>
          <pgNum>2</pgNum>
          <minOrderQuantity>1</minOrderQuantity>
          <pgPrice>20.00</pgPrice>
        </pgInfo>
        <arrivalPrice>1</arrivalPrice>
        <parametersList>
          <explain>说明</explain>
          <parameterDesc>1</parameterDesc>
          <sequence>1</sequence>
          <parameterVal>1</parameterVal>
          <parametersCode>1</parametersCode>
          <parameterSequence>1</parameterSequence>
          <coreFlag>1</coreFlag>
          <parametersDesc>1</parametersDesc>
          <parameterCode>1</parameterCode>
        </parametersList>
        <categoryInfo>
          <firstPurchaseCategoryId>R001</firstPurchaseCategoryId>
          <secondPurchaseCategoryId>R002</secondPurchaseCategoryId>
          <goodsGroupCategoryId>R9001213</goodsGroupCategoryId>
          <firstPurchaseCategoryName>一级采购目录名称示例</firstPurchaseCategoryName>
          <thirdSaleCategoryId>50000</thirdSaleCategoryId>
          <secondSaleCategoryId>50000</secondSaleCategoryId>
          <secondSaleCategoryName>二级销售目录名称示例</secondSaleCategoryName>
          <goodsGroupCategoryName>商品组目录名称示例</goodsGroupCategoryName>
          <firstSaleCategoryId>50000</firstSaleCategoryId>
          <thirdPurchaseCategoryId>R003</thirdPurchaseCategoryId>
          <firstSaleCategoryName>一级销售目录名称示例</firstSaleCategoryName>
          <thirdSaleCategoryName>三级销售目录名称示例</thirdSaleCategoryName>
          <thirdPurchaseCategoryName>三级采购目录名称示例</thirdPurchaseCategoryName>
          <secondPurchaseCategoryName>二级采购目录名称示例</secondPurchaseCategoryName>
        </categoryInfo>
        <cmmdtyReviewInfo>
          <goodRate>12</goodRate>
          <goodReviewCount>123</goodReviewCount>
          <totalReviewCount>123</totalReviewCount>
        </cmmdtyReviewInfo>
        <commodityInfo>
          <supplierName>供应商名称示例</supplierName>
          <pictureUrl>
            <picUrl>https://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e</picUrl>
            <locationId>1</locationId>
          </pictureUrl>
          <priceType>大聚惠</priceType>
          <baoyou>1</baoyou>
          <sellingPoint>卖点示例</sellingPoint>
          <saleStatus>1</saleStatus>
          <supplierCode>0000000000</supplierCode>
          <commodityPrice>99.00</commodityPrice>
          <commodityType>1</commodityType>
          <monthSales>1000</monthSales>
          <snPrice>100.0</snPrice>
          <forbiddenMark>1</forbiddenMark>
          <isAct>1</isAct>
          <priceTypeCode>1</priceTypeCode>
          <rate>20.00</rate>
          <commodityCode>121307256</commodityCode>
          <productUrl>https://product.suning.com/供应商编码/商品编码.html</productUrl>
          <commodityName>商品名称示例</commodityName>
        </commodityInfo>
      </commodityList>
    </querySelectrecommendcommodity>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "querySelectrecommendcommodity": {
        "commodityList": [
          {
            "advanceSale": [
              {
                "depositAmount": "20",
                "depositEndTime": "2017-10-10 10:00:00",
                "isReserveCommodity": "1"
              }
            ],
            "subCodeList": [
              {
                "subCode": "123"
              }
            ],
            "isHaveData": "1",
            "couponInfo": [
              {
                "activitySecretKey": "mzekhfSGwaRrZIopV0M1wGRM",
                "couponShowType": "1",
                "afterCouponPrice": "60.00",
                "couponCount": "1000",
                "couponUrl": "\thttps://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM",
                "couponValue": "10.00",
                "bounsLimit": "15.00",
                "couponEndTime": "2019-07-04 17:10:47",
                "activityId": "201907040010040371",
                "preferentialDistinct": "奖励优惠说明",
                "couponStartTime": "2019-07-04 17:10:47",
                "descriptionForList": "列表页券描述",
                "startTime": "2019-07-04 17:10:47",
                "activityDescription": "免费领取送券10元",
                "endTime": "2019-07-04 17:10:47",
                "bounsAmount": "1"
              }
            ],
            "couponInfoList": [
              {
                "activitySecretKey": "llOAnJF1OmD2nlgtjtkBwj2l",
                "bounsLimit": "2",
                "couponEndTime": "2021-11-02 11:41:37",
                "activityId": "202105060010204429",
                "couponStartTime": "2021-05-06 11:41:37",
                "couponCount": "999",
                "couponUrl": "http://quanpre.cnsuning.com/lqzx_recommend.do?activityId=202105060010204429&activitySecretKey=llOAnJF1OmD2nlgtjtkBwj2l",
                "startTime": "2021-05-06 11:41:39",
                "activityDescription": "活动描述",
                "endTime": "2021-11-02 11:41:37",
                "couponValue": "1"
              }
            ],
            "orderActivity": [
              {
                "activityRuleList": [
                  {
                    "rewardAmount": "0.2",
                    "floor": "1",
                    "baseAmount": "2"
                  }
                ],
                "activityDescription": "满2件打8折"
              }
            ],
            "pgInfo": [
              {
                "pgUrl": "https://pin.suning.com/pgs/product/45918238111498247256.html",
                "pgActionId": "45918238111498247256",
                "pgNum": "2",
                "minOrderQuantity": "1",
                "pgPrice": "20.00"
              }
            ],
            "arrivalPrice": "1",
            "parametersList": [
              {
                "explain": "说明",
                "parameterDesc": "1",
                "sequence": "1",
                "parameterVal": "1",
                "parametersCode": "1",
                "parameterSequence": "1",
                "coreFlag": "1",
                "parametersDesc": "1",
                "parameterCode": "1"
              }
            ],
            "categoryInfo": [
              {
                "firstPurchaseCategoryId": "R001",
                "secondPurchaseCategoryId": "R002",
                "goodsGroupCategoryId": "R9001213",
                "firstPurchaseCategoryName": "一级采购目录名称示例",
                "thirdSaleCategoryId": "50000",
                "secondSaleCategoryId": "50000",
                "secondSaleCategoryName": "二级销售目录名称示例",
                "goodsGroupCategoryName": "商品组目录名称示例",
                "firstSaleCategoryId": "50000",
                "thirdPurchaseCategoryId": "R003",
                "firstSaleCategoryName": "一级销售目录名称示例",
                "thirdSaleCategoryName": "三级销售目录名称示例",
                "thirdPurchaseCategoryName": "三级采购目录名称示例",
                "secondPurchaseCategoryName": "二级采购目录名称示例"
              }
            ],
            "cmmdtyReviewInfo": [
              {
                "goodRate": "12",
                "goodReviewCount": "123",
                "totalReviewCount": "123"
              }
            ],
            "commodityInfo": [
              {
                "supplierName": "供应商名称示例",
                "pictureUrl": [
                  {
                    "picUrl": "https://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e",
                    "locationId": "1"
                  }
                ],
                "priceType": "大聚惠",
                "baoyou": "1",
                "sellingPoint": "卖点示例",
                "saleStatus": "1",
                "supplierCode": "0000000000",
                "commodityPrice": "99.00",
                "commodityType": "1",
                "monthSales": "1000",
                "snPrice": "100.0",
                "forbiddenMark": "1",
                "isAct": "1",
                "priceTypeCode": "1",
                "rate": "20.00",
                "commodityCode": "121307256",
                "productUrl": "https://product.suning.com/供应商编码/商品编码.html",
                "commodityName": "商品名称示例"
              }
            ]
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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