API接口目录

网盟业务

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

通过联盟商品链接,进行批量转链,同时返回商品的详情数据

公共参数
请求参数
名称 类型 是否必须 示例值 描述
contentStringYhttp://productpre.cnsuning.com/0070057494/761407749.html,https://sugspre.cnsuning.com/YDX7WRLV商品链接(多个链接用英文逗号隔开)
promotionIdStringN0000000000推广位id
cityCodeStringY025城市编码
subUserStringN1111111子会员编码
响应参数
名称 类型 示例值 描述
dataString
commodityString
commodityInfoString
commodityNameString商品名称示例商品名称
commodityCodeString761137021商品编码
supplierCodeString0000000000供应商编码
pictureUrlString
locationIdString1图片位置
picUrlStringhttp://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e图片url
sellingPointString商品卖点示例商品卖点
monthSalesString1000月销量
snPriceString99.9易购价
commodityPriceString98.99商品价格
commodityTypeString1商品类型 1:自营 2:C店 3:海外购自营 4:海外购 5:特卖 6:极物
priceTypeString大聚惠价格类型
priceTypeCodeString1价格类型编码 0:正常价格,1:大聚惠 , 2:抢购, 3:渠道专享, 4:限时促销 ,5:爆款抢购,6:掌上抢,7:特卖,99:乐拼购
baoyouString1是否包邮 0:不包邮 1:包邮
rateString20.00佣金比例 (数值为百分比数据)
saleStatusString0是否可售 0:可售,1:无货,2:本地暂不销售
productUrlStringhttps://product.suning.com/供应商编码/商品编码.html四级页地址
forbiddenMarkString01:禁售 0:非禁售
isActString10不是 1是
categoryInfoString
firstSaleCategoryIdString5000000一级销售目录ID
firstSaleCategoryNameString一级销售目录名称示例一级销售目录名称
secondSaleCategoryIdString50000二级销售目录ID
secondSaleCategoryNameString二级销售目录名称示例二级销售目录名称
thirdSaleCategoryIdString50000三级销售目录ID
thirdSaleCategoryNameString三级销售目录名称示例三级销售目录名称
firstPurchaseCategoryIdStringR001一级采购目录ID
firstPurchaseCategoryNameString一级采购目录名称示例一级采购目录名称
secondPurchaseCategoryIdStringR002二级采购目录ID
secondPurchaseCategoryNameString二级采购目录名称示例二级采购目录名称
thirdPurchaseCategoryIdStringR003三级采购目录ID
thirdPurchaseCategoryNameString三级采购目录名称示例三级采购目录名称
goodsGroupCategoryIdStringR9001213商品组目录ID
goodsGroupCategoryNameString商品组目录名称示例商品组目录名称
pgInfoString
pgNumString2成团人数
pgPriceString20.00拼购价
pgUrlStringhttps://pin.suning.com/pgs/product/45918238111498247256.html拼购四级页地址
pgActionIdString45918238111498247256拼购活动ID
minOrderQuantityString1拼购商品起售数量
couponInfoString
couponUrlStringhttps://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM券链接URL
activityIdString201907040010040371券活动编码
activitySecretKeyStringmzekhfSGwaRrZIopV0M1wGRM券秘钥
couponValueString10.00券面额
couponCountString2000券总数
couponStartTimeString2023-07-04 17:10:47券领取开始时间
couponEndTimeString2023-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列表页券描述列表页券描述
bounsAmountString奖励数值(券面额)奖励数值(券面额)
advanceSaleString
isReserveCommodityString1是否预售
depositAmountString100定金
depositEndTimeString2017-10-10 10:00:00付定金结束时间
orderActivityString
activityRuleListString
floorString1层级
baseAmountString2基数数值
rewardAmountString0.2奖励数值
activityDescriptionString满2件打8折奖励描述
cmmdtyReviewInfoString
totalReviewCountString321评价总数
goodReviewCountString888好评数量
goodRateString98好评率
subCodeListString
subCodeString12345子码
parametersListString
parameterCodeString2参数代码
parameterSequenceString12参数排序码
parameterDescString12参数描述
parameterValString12参数描述值
parametersCodeString12参数组代码
parametersDescString12参数组描述
sequenceString1参数组排序
explainString说明参数说明文
coreFlagString1核心参数
arrivalPriceString91.00到手价
linkUrlStringhttps://sugspre.cnsuning.com/YGrPxyJz转链后的链接
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryCustomlinkandgetcommodity>
      <cityCode>025</cityCode>
      <subUser>1111111</subUser>
      <content>http://productpre.cnsuning.com/0070057494/761407749.html,https://sugspre.cnsuning.com/YDX7WRLV</content>
      <promotionId>0000000000</promotionId>
    </queryCustomlinkandgetcommodity>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryCustomlinkandgetcommodity": {
        "cityCode": "025",
        "subUser": "1111111",
        "content": "http://productpre.cnsuning.com/0070057494/761407749.html,https://sugspre.cnsuning.com/YDX7WRLV",
        "promotionId": "0000000000"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryCustomlinkandgetcommodity>
      <data>
        <commodity>
          <advanceSale>
            <depositAmount>100</depositAmount>
            <depositEndTime>2017-10-10 10:00:00</depositEndTime>
            <isReserveCommodity>1</isReserveCommodity>
          </advanceSale>
          <subCodeList>
            <subCode>12345</subCode>
          </subCodeList>
          <couponInfo>
            <activitySecretKey>mzekhfSGwaRrZIopV0M1wGRM</activitySecretKey>
            <couponShowType>1</couponShowType>
            <afterCouponPrice>60.00</afterCouponPrice>
            <couponCount>2000</couponCount>
            <couponUrl>https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&amp;activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM</couponUrl>
            <couponValue>10.00</couponValue>
            <bounsLimit>15.00</bounsLimit>
            <couponEndTime>2023-07-04 17:10:47</couponEndTime>
            <activityId>201907040010040371</activityId>
            <preferentialDistinct>奖励优惠说明</preferentialDistinct>
            <couponStartTime>2023-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>奖励数值(券面额)</bounsAmount>
          </couponInfo>
          <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>91.00</arrivalPrice>
          <parametersList>
            <explain>说明</explain>
            <parameterDesc>12</parameterDesc>
            <sequence>1</sequence>
            <parameterVal>12</parameterVal>
            <parametersCode>12</parametersCode>
            <parameterSequence>12</parameterSequence>
            <coreFlag>1</coreFlag>
            <parametersDesc>12</parametersDesc>
            <parameterCode>2</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>5000000</firstSaleCategoryId>
            <thirdPurchaseCategoryId>R003</thirdPurchaseCategoryId>
            <firstSaleCategoryName>一级销售目录名称示例</firstSaleCategoryName>
            <thirdSaleCategoryName>三级销售目录名称示例</thirdSaleCategoryName>
            <thirdPurchaseCategoryName>三级采购目录名称示例</thirdPurchaseCategoryName>
            <secondPurchaseCategoryName>二级采购目录名称示例</secondPurchaseCategoryName>
          </categoryInfo>
          <cmmdtyReviewInfo>
            <goodRate>98</goodRate>
            <goodReviewCount>888</goodReviewCount>
            <totalReviewCount>321</totalReviewCount>
          </cmmdtyReviewInfo>
          <commodityInfo>
            <pictureUrl>
              <picUrl>http://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>0</saleStatus>
            <supplierCode>0000000000</supplierCode>
            <commodityPrice>98.99</commodityPrice>
            <commodityType>1</commodityType>
            <monthSales>1000</monthSales>
            <snPrice>99.9</snPrice>
            <forbiddenMark>0</forbiddenMark>
            <isAct>1</isAct>
            <priceTypeCode>1</priceTypeCode>
            <rate>20.00</rate>
            <commodityCode>761137021</commodityCode>
            <productUrl>https://product.suning.com/供应商编码/商品编码.html</productUrl>
            <commodityName>商品名称示例</commodityName>
          </commodityInfo>
        </commodity>
        <linkUrl>https://sugspre.cnsuning.com/YGrPxyJz</linkUrl>
      </data>
    </queryCustomlinkandgetcommodity>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryCustomlinkandgetcommodity": {
        "data": [
          {
            "commodity": {
              "advanceSale": {
                "depositAmount": "100",
                "depositEndTime": "2017-10-10 10:00:00",
                "isReserveCommodity": "1"
              },
              "subCodeList": [
                {
                  "subCode": "12345"
                }
              ],
              "couponInfo": {
                "activitySecretKey": "mzekhfSGwaRrZIopV0M1wGRM",
                "couponShowType": "1",
                "afterCouponPrice": "60.00",
                "couponCount": "2000",
                "couponUrl": "https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM",
                "couponValue": "10.00",
                "bounsLimit": "15.00",
                "couponEndTime": "2023-07-04 17:10:47",
                "activityId": "201907040010040371",
                "preferentialDistinct": "奖励优惠说明",
                "couponStartTime": "2023-07-04 17:10:47",
                "descriptionForList": "列表页券描述",
                "startTime": "2019-07-04 17:10:47",
                "activityDescription": "免费领取送券10元",
                "endTime": "2019-07-04 17:10:47",
                "bounsAmount": "奖励数值(券面额)"
              },
              "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": "91.00",
              "parametersList": [
                {
                  "explain": "说明",
                  "parameterDesc": "12",
                  "sequence": "1",
                  "parameterVal": "12",
                  "parametersCode": "12",
                  "parameterSequence": "12",
                  "coreFlag": "1",
                  "parametersDesc": "12",
                  "parameterCode": "2"
                }
              ],
              "categoryInfo": {
                "firstPurchaseCategoryId": "R001",
                "secondPurchaseCategoryId": "R002",
                "goodsGroupCategoryId": "R9001213",
                "firstPurchaseCategoryName": "一级采购目录名称示例",
                "thirdSaleCategoryId": "50000",
                "secondSaleCategoryId": "50000",
                "secondSaleCategoryName": "二级销售目录名称示例",
                "goodsGroupCategoryName": "商品组目录名称示例",
                "firstSaleCategoryId": "5000000",
                "thirdPurchaseCategoryId": "R003",
                "firstSaleCategoryName": "一级销售目录名称示例",
                "thirdSaleCategoryName": "三级销售目录名称示例",
                "thirdPurchaseCategoryName": "三级采购目录名称示例",
                "secondPurchaseCategoryName": "二级采购目录名称示例"
              },
              "cmmdtyReviewInfo": {
                "goodRate": "98",
                "goodReviewCount": "888",
                "totalReviewCount": "321"
              },
              "commodityInfo": {
                "pictureUrl": [
                  {
                    "picUrl": "http://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e",
                    "locationId": "1"
                  }
                ],
                "priceType": "大聚惠",
                "baoyou": "1",
                "sellingPoint": "商品卖点示例",
                "saleStatus": "0",
                "supplierCode": "0000000000",
                "commodityPrice": "98.99",
                "commodityType": "1",
                "monthSales": "1000",
                "snPrice": "99.9",
                "forbiddenMark": "0",
                "isAct": "1",
                "priceTypeCode": "1",
                "rate": "20.00",
                "commodityCode": "761137021",
                "productUrl": "https://product.suning.com/供应商编码/商品编码.html",
                "commodityName": "商品名称示例"
              }
            },
            "linkUrl": "https://sugspre.cnsuning.com/YGrPxyJz"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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