小于电商开放平台-获取商品列表

简要描述

• 获取商品列表

请求URL

• {Host}/lt-third/api/goods/list，见【基础参数说明】

请求方式

• GET 方式发送参数
• POST 方式发送参数。当使用 POST 时，请求的主体必须是 JSON 格式，而且 HTTP header 的 Content-Type 需要设置为 application/json

请求参数说明

参数名	必选	类型	说明
appId	是	string	应用AppId
appSecret	是	string	应用AppSecret
platformShopIds	否	string	【API-店铺ID】集合 可逗号隔开
platformGoodsIds	否	string	【API-商品ID】集合 可逗号隔开
createStartTime	否	string	商品创建开始时间，格式： yyyy-MM-dd HH:mm:ss
createEndTime	否	string	商品创建结束时间，格式： yyyy-MM-dd HH:mm:ss
updateStartTime	否	string	数据更新开始时间，格式： yyyy-MM-dd HH:mm:ss
updateEndTime	否	string	数据更新结束时间，格式： yyyy-MM-dd HH:mm:ss
pageIndex	否	int	页码，默认值为1
pageSize	否	int	每页记录数，默认值为20 取值范围：1~50
keywords	否	string	关键词

请求示例

POST {Host}/lt-third/api/goods/list
Content-Type: application/json

{
  "appId": "RlYajTa4hd74xh4FuGrVkDPx",
  "appSecret": "uy8wHbPohwT8cB1HncTJaZaBSmVwaV",
  "pageIndex": 1,
  "pageSize": 10
}

返回参数说明

参数名	类型	说明
code	int	状态码
msg	string	描述
data	object
total	int	总行数
rows	Goods[]	商品列表

Goods 实体：

参数名	类型	说明
platformGoodsId	string	商品ID，唯一值
platformShopId	string	店铺ID，唯一值
thirdPlatform	string	对接平台，见【字典数据】
platformShopNo	string	平台店铺ID
platformGoodsNo	string	平台商品ID
goodsLogo	string	商品图片
goodsTitle	string	商品标题
goodsSn	string	商品编码
goodsDetail	string	商品详情
goodsPrice	number	商品参考价，最多保留4位小数
goodsCreateTime	string	商品创建时间，格式： yyyy-MM-dd HH:mm:ss
saleStatus	string	上架状态文本
goodsStatusValue	string	商品状态值（0-未上架/1-已上架/2-删除）
skuList	Sku[]	商品规格-库存价格列表
updateTime	string	数据更新时间，格式： yyyy-MM-dd HH:mm:ss
otherInfo	string	其他信息JSON字符串，每个平台定制字段，见【字典数据】

Sku 实体：

参数名	类型	说明
skuId	string	平台规格-库存价格ID
specName	string	规格SKU名称
skuImg	string	规格SKU图片
skuQuantity	int	当前库存数量
skuSn	string	规格SKU编码
skuPrice	number	价格，最多保留4位小数
saleStatus	string	上架状态文本
saleStatusValue	string	上架状态值（0-未上架/1-已上架）

返回示例

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "total": 15,
    "rows": [
      {
        "platformGoodsId": "doudian_77844856_3588123425924850693",
        "platformShopId": "doudian_77844856",
        "thirdPlatform": "doudian",
        "platformShopNo": "77844856",
        "platformGoodsNo": "3588123425924850693",
        "goodsLogo": "https://p6-aio.ecombdimg.com/obj/e505bb853f_sx_58687_www800-800",
        "goodsTitle": "巧发力羽毛球训练器 练习器辅助发力阻力拍套器 羽毛球挥拍训练器",
        "goodsSn": "HH001",
        "goodsDetail": "",
        "goodsPrice": 170.90,
        "goodsCreateTime": "2023-02-13 17:16:47",
        "saleStatus": "已上架",
        "goodsStatusValue": "1",
        "skuList": [
          {
            "skuId": "1752013390480428",
            "specName": "3050 蓝色",
            "skuImg": "",
            "skuQuantity": 0,
            "skuSn": "BM02",
            "skuPrice": 170.9000,
            "saleStatus": "已上架",
            "saleStatusValue": "1"
          },
          {
            "skuId": "1752013390480412",
            "specName": "3050 黄色",
            "skuImg": "",
            "skuQuantity": 0,
            "skuSn": "BM01",
            "skuPrice": 170.9000,
            "saleStatus": "已上架",
            "saleStatusValue": "1"
          }
        ],
        "updateTime": "2023-02-13 17:16:47",
        "otherInfo": "{\"promotionId\": \"3652072598491242673\", \"commissionCosRatio\": 30, \"commission\": 3.84, \"gmv\": 0, \"pvExposureRate\": 0}"
      },
      {
        "platformGoodsId": "doudian_77844856_3587199297139143582",
        "platformShopId": "doudian_77844856",
        "thirdPlatform": "doudian",
        "platformShopNo": "77844856",
        "platformGoodsNo": "3587199297139143582",
        "goodsLogo": "https://p6-aio.ecombdimg.com/obj/sx_58687_www800-800",
        "goodsTitle": "巧发力羽毛球训练器 练习器辅助发力阻力拍套器 羽毛球挥拍训练器",
        "goodsSn": "",
        "goodsDetail": "",
        "goodsPrice": 190.90,
        "goodsCreateTime": "2023-02-13 17:16:40",
        "saleStatus": "已上架",
        "goodsStatusValue": "1",
        "skuList": null,
        "updateTime": "2023-02-13 17:16:47",
        "otherInfo": "{\"promotionId\": \"3649456602412638390\", \"commissionCosRatio\": 50, \"commission\": 3, \"gmv\": 0, \"pvExposureRate\": 0}"
      }
    ]
  }
}

联系我们

小于电商开放平台
手机：13267238092