API接口目录

网盟业务

会员API
联盟订单API
大聚惠API
联盟商品API
招商推广活动API
获取推广链接API
优惠券推广API
机构推客API
店铺API
异常码自查工具
suning.netalliance.recommendcommodity.query 小编推荐接口,准备下线
¥免费

小编推荐接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageIndexStringN1页码 默认0
cityCodeStringN025城市编码 默认025
picWidthStringN200图片宽度 默认200
picHeightStringN200图片高度 默认200
sizeStringN10每页数量,默认10
couponMarkStringN11表示拿到券后价,不传按照以前逻辑取不到券后价
响应参数
名称 类型 示例值 描述
commodityInfoString
commodityNameString商品名称示例商品名称
commodityCodeString121307256商品编码
supplierCodeString0000000000供应商编码
supplierNameString供应商名称示例供应商名称
pictureUrlString
locationIdString1图片位置
picUrlStringhttps://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e图片URL
sellingPointString卖点示例卖点
monthSalesString100月销量
snPriceString100.00易购价
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:本地暂不销售
pgInfoString
pgNumString2成团人数
pgPriceString20.00拼购价
pgUrlStringhttps://pin.suning.com/pgs/product/45918238111498247256.html拼购四级页地址
pgActionIdString45918238111498247256拼购活动ID
categoryInfoString
firstSaleCategoryIdString50000一级销售目录ID
firstSaleCategoryNameString一级销售目录名称示例一级销售目录名称
secondSaleCategoryIdString50000二级销售目录ID
secondSaleCategoryNameString二级销售目录名称示例二级销售目录名称
thirdSaleCategoryIdString50000三级销售目录ID
thirdSaleCategoryNameString三级销售目录名称示例三级销售目录名称
firstPurchaseCategoryIdStringR001一级采购目录ID
firstPurchaseCategoryNameString一级采购目录名称示例一级采购目录名称
secondPurchaseCategoryIdStringR002二级采购目录ID
secondPurchaseCategoryNameString二级采购目录名称示例二级采购目录名称
thirdPurchaseCategoryIdStringR003三级采购目录ID
thirdPurchaseCategoryNameString三级采购目录名称示例三级采购目录名称
goodsGroupCategoryIdStringR9001213商品组目录ID
goodsGroupCategoryNameString商品组目录名称示例商品组目录名称
couponInfoString
couponUrlStringhttps://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券后价
advanceSaleString
isReserveCommodityString1是否预售 1:是 0:否
depositAmountString20定金
depositEndTimeString2017-10-10 10:00:00付定金结束时间
isHaveDataString11:下一页有值 0:下一页无值
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryRecommendcommodity>
      <picWidth>200</picWidth>
      <couponMark>1</couponMark>
      <picHeight>200</picHeight>
      <size>10</size>
      <pageIndex>1</pageIndex>
      <cityCode>025</cityCode>
    </queryRecommendcommodity>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryRecommendcommodity": {
        "picWidth": "200",
        "couponMark": "1",
        "picHeight": "200",
        "size": "10",
        "pageIndex": "1",
        "cityCode": "025"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryRecommendcommodity>
      <advanceSale>
        <depositAmount>20</depositAmount>
        <depositEndTime>2017-10-10 10:00:00</depositEndTime>
        <isReserveCommodity>1</isReserveCommodity>
      </advanceSale>
      <isHaveData>1</isHaveData>
      <couponInfo>
        <activitySecretKey>mzekhfSGwaRrZIopV0M1wGRM</activitySecretKey>
        <bounsLimit>15.00</bounsLimit>
        <couponEndTime>2019-07-04 17:10:47</couponEndTime>
        <activityId>201907040010040371</activityId>
        <afterCouponPrice>60.00</afterCouponPrice>
        <couponStartTime>2019-07-04 17:10:47</couponStartTime>
        <couponCount>1000</couponCount>
        <couponUrl>https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&amp;activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM</couponUrl>
        <startTime>2019-07-04 17:10:47</startTime>
        <activityDescription>免费领取送券10元</activityDescription>
        <endTime>2019-07-04 17:10:47</endTime>
        <couponValue>10.00</couponValue>
      </couponInfo>
      <pgInfo>
        <pgUrl>https://pin.suning.com/pgs/product/45918238111498247256.html</pgUrl>
        <pgActionId>45918238111498247256</pgActionId>
        <pgNum>2</pgNum>
        <pgPrice>20.00</pgPrice>
      </pgInfo>
      <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>
      <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>100</monthSales>
        <snPrice>100.00</snPrice>
        <priceTypeCode>1</priceTypeCode>
        <rate>20.00</rate>
        <commodityCode>121307256</commodityCode>
        <commodityName>商品名称示例</commodityName>
      </commodityInfo>
    </queryRecommendcommodity>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryRecommendcommodity": [
        {
          "advanceSale": [
            {
              "depositAmount": "20",
              "depositEndTime": "2017-10-10 10:00:00",
              "isReserveCommodity": "1"
            }
          ],
          "isHaveData": "1",
          "couponInfo": [
            {
              "activitySecretKey": "mzekhfSGwaRrZIopV0M1wGRM",
              "bounsLimit": "15.00",
              "couponEndTime": "2019-07-04 17:10:47",
              "activityId": "201907040010040371",
              "afterCouponPrice": "60.00",
              "couponStartTime": "2019-07-04 17:10:47",
              "couponCount": "1000",
              "couponUrl": "https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM",
              "startTime": "2019-07-04 17:10:47",
              "activityDescription": "免费领取送券10元",
              "endTime": "2019-07-04 17:10:47",
              "couponValue": "10.00"
            }
          ],
          "pgInfo": [
            {
              "pgUrl": "https://pin.suning.com/pgs/product/45918238111498247256.html",
              "pgActionId": "45918238111498247256",
              "pgNum": "2",
              "pgPrice": "20.00"
            }
          ],
          "categoryInfo": [
            {
              "firstPurchaseCategoryId": "R001",
              "secondPurchaseCategoryId": "R002",
              "goodsGroupCategoryId": "R9001213",
              "firstPurchaseCategoryName": "一级采购目录名称示例",
              "thirdSaleCategoryId": "50000",
              "secondSaleCategoryId": "50000",
              "secondSaleCategoryName": "二级销售目录名称示例",
              "goodsGroupCategoryName": "商品组目录名称示例",
              "firstSaleCategoryId": "50000",
              "thirdPurchaseCategoryId": "R003",
              "firstSaleCategoryName": "一级销售目录名称示例",
              "thirdSaleCategoryName": "三级销售目录名称示例",
              "thirdPurchaseCategoryName": "三级采购目录名称示例",
              "secondPurchaseCategoryName": "二级采购目录名称示例"
            }
          ],
          "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": "100",
              "snPrice": "100.00",
              "priceTypeCode": "1",
              "rate": "20.00",
              "commodityCode": "121307256",
              "commodityName": "商品名称示例"
            }
          ]
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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