分页获取分组内商品

接口地址: /open-api/product/spu/page

请求方式: POST

接口描述: 分页获取特定分组内的商品数据

公共请求参数:

参数名称参数说明请求类型是否必须数据类型示例值
appId应用IDheadertruestringtest
nonce随机字符串headertruestring75ba4a58-8db0-4ce0-b403-2ccc8dbaea72
timestamp时间戳headertruestring1772763315016
sign签名串headertruestring89f4ad32ea7151cc33477215c24e8020bfb801a9a805a1369d9d6ceddc67a7e4

业务请求参数：

参数名类型必填说明示例值
pageNonumber是页码, 最小值为12
pageSizenumber是页大小, 最大值为20015
groupIdnumber是商品分组ID88

请求示例

  1. {
  2.     "pageNo": 2,
  3.     "pageSize": 15,
  4.     "groupId": 88
  5. }

响应参数

参数名类型说明示例值
codeInteger响应码，0表示成功0
dataJSONObject分页数据见分页数据详情
msgString响应消息成功

分页数据详情

参数名类型说明示例值
totalnumber数据总数999
listJSONOArray数据列表见业务数据说明

data 业务数据 (JSONObject)

参数名称参数说明类型示例值
id商品idnumber1711064111
name商品名称string测试商品名称
introduction商品简介string555
description商品详细描述string商品描述
categoryId分类idnumber1036135111
categoryName分类名称string饮料
brandId品牌idnumber1100111025
brandName品牌名称string测试品牌001
independentOperation是否独立运营[0:否, 1:是]number0
shelfLife保质期数值number5
shelfLifeUnit保质期单位[1-天，2-月，3-年]number1
isSupportNoReasonReturn是否支持7天无理由退货[0:否, 1:是]booleantrue
picUrl主图URLstringurl
sliderPicUrls轮播图URL数组array of string[“url”,”url1”,”url2”]
mediaUrl媒体文件URL（视频等）string / nullnull
keyword关键词string55
attributes自定义属性数组[json数组]array[]
serviceTel服务电话string“55555555”
traceabilityUrl追溯信息URLstring / nullnull
specType是否多规格booleantrue
price商品售价（单位：分）number100
marketPrice市场价（单位：分）number531500
stock总库存number114208
type商品类型[1:普通商品, 2:虚拟商品, 3:票付通商品]number1
deliveryTypes配送方式数组[1:快递发货, 2:用户自提, 3:卡密卡号, 4:电子券码]array of number[1,2]
skusSKU列表（详见下方子表）array of object见子表
salesCount销量number2

skus 子表（每个SKU对象字段）：

参数名称参数说明类型示例值
idSKU idnumber50321821
properties规格属性数组array of object[{“propertyId”:425,”propertyName”:”口味”,”valueId”:60243938,”valueName”:”西瓜”}]
priceSKU售价（分）number100
marketPriceSKU市场价（分）number5500
vipPrice会员价（分），可为nullnumber / nullnull
picUrlSKU图片URLstring“”
stockSKU库存number553
weight重量（千克）number0
volume体积（立方米）number0

响应示例

成功响应:

  1. {
  2.     "code": 0,
  3.     "msg": "",
  4.     "data": {
  5.         "total": 999,
  6.         "list": [
  7.             {
  8.                 "id": 1711064111,
  9.                 "name": "测试商品名称",
  10.                 "introduction": "555",
  11.                 "description": "商品描述",
  12.                 "categoryId": 1036135111,
  13.                 "categoryName": "饮料",
  14.                 "brandId": 1100111025,
  15.                 "brandName": "测试品牌001",
  16.                 "independentOperation": 0,
  17.                 "shelfLife": 5,
  18.                 "shelfLifeUnit": 1,
  19.                 "isSupportNoReasonReturn": true,
  20.                 "picUrl": "url",
  21.                 "sliderPicUrls": [
  22.                     "url",
  23.                     "url1",
  24.                     "url2"
  25.                 ],
  26.                 "mediaUrl": null,
  27.                 "keyword": "55",
  28.                 "attributes": [
  30.                 ],
  31.                 "serviceTel": "55555555",
  32.                 "traceabilityUrl": null,
  33.                 "specType": true,
  34.                 "price": 100,
  35.                 "marketPrice": 531500,
  36.                 "stock": 114208,
  37.                 "type": 1,
  38.                 "deliveryTypes": [
  39.                     1,
  40.                     2
  41.                 ],
  42.                 "skus": [
  43.                     {
  44.                         "id": 50321821,
  45.                         "properties": [
  46.                             {
  47.                                 "propertyId": 425,
  48.                                 "propertyName": "口味",
  49.                                 "valueId": 60243938,
  50.                                 "valueName": "西瓜"
  51.                             }
  52.                         ],
  53.                         "price": 100,
  54.                         "marketPrice": 5500,
  55.                         "vipPrice": null,
  56.                         "picUrl": "",
  57.                         "stock": 553,
  58.                         "weight": 0,
  59.                         "volume": 0
  60.                     },
  61.                     {
  62.                         "id": 501493822,
  63.                         "properties": [
  64.                             {
  65.                                 "propertyId": 425,
  66.                                 "propertyName": "口味",
  67.                                 "valueId": 60242936,
  68.                                 "valueName": "苹果"
  69.                             }
  70.                         ],
  71.                         "price": 100,
  72.                         "marketPrice": 5500,
  73.                         "vipPrice": null,
  74.                         "picUrl": "",
  75.                         "stock": 555,
  76.                         "weight": 0,
  77.                         "volume": 0
  78.                     }
  79.                 ],
  80.                 "salesCount": 2
  81.             }
  82.         ]
  83.     }
  84. }

失败响应:

  1. {
  2.     "code": 400,
  3.     "msg": "签名不正确",
  4.     "data": null
  5. }
  1. {
  2.     "code": 0,
  3.     "msg": "",
  4.     "data": {
  5.         "total": 0,
  6.         "list": []
  7.     }
  8. }