获取商品列表 - 人人商城V5开放接口

适用对象： 开放应用

请求参数

Query 参数

status

integer

可选

商品状态默认取上架下架售罄状态 1上架 2售罄 3下架 4删除 5上架和售罄

示例值:

keywords

string

可选

搜索(商品名称|商品条码|商品编码)

示例值:

手机

label_field

string

可选

营销标签 is_recommand推荐 is_hot热卖 is_new新品

示例值:

is_recommand

create_time

array[string]

创建时间

可选

示例值:

["[\"2022-05-18 05:00:00\", \"2022-05-30 00:00:00\"]"]

create_time_start

string

可选

创建时间扩展字段，开始时间

示例值:

2022-05-18 05:00:00

create_time_end

string

可选

创建时间扩展字段，结束时间

示例值:

2022-05-30 00:00:00

type

integer

可选

商品类型默认全部商品 0实体商品 1虚拟商品 2虚拟卡密 3预约到店 5计次时商品

示例值:

category_id

array[string]

可选

按照商品分类ID查询

示例值:

["[1,2,3]"]

group_id

array[string]

可选

按照商品分组ID查询

示例值:

["[1,2,3]"]

dispatch_type

integer

可选

按照物流方式查询 10普通快递 20自提(核销) 30同城配送

示例值:

page

integer

页码

可选

示例值:

pagesize

integer

获取商品列表条数

可选

示例值:

sub_shop_name

string

可选

按商户名称(模糊搜索)查询

示例值:

商户名称1

sub_shop_id

string

可选

按商户id搜索, 需要一级店铺为多商户店铺时此参数才有效

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

error

integer

必需

出错返回码，为0表示成功，非0表示调用失败

total

integer

商品总数量

必需

list

array [object {38}]

商品列表

必需

string

商品ID

可选

create_time

string

商品添加时间

可选

title

string

商品名称

可选

sub_title

string

商品副标题

可选

short_title

string

可选

短标题, 用于打印机

type

string

可选

商品类型 0实体商品 1虚拟商品 2虚拟卡密 3预约到店 5计次时商品

thumb

string

商品封面图第一张

可选

thumb_all

array[string]

所有商品封面图

可选

video

string

首图视频

可选

video_thumb

string

视频首图

可选

unit

string

商品单位, 默认件

可选

goods_code

string

商品编码

可选

bar_code

string

商品条码

可选

display_order

string

可选

商品排序默认0 越大越靠前

stock

string

库存

可选

stock_warning

string

可选

商品预警库存低于该值预警

real_sales

string

实际销售量

可选

price

string

商品价格

可选

min_price

string

最低销售价

可选

max_price

string

最高销售价

可选

cost_price

string

成本价

可选

original_price

string

商品原始价格

可选

view_count

string

浏览量

可选

has_option

string

可选

是否启动多规格 0不启用 1启用

is_hot

string

可选

是否热卖 0不是 1是

is_recommand

string

可选

是否推荐 0不推荐 1推荐

is_new

string

可选

是否新品 0不是 1是

status

string

可选

状态 0下架 1上架 2上架不显示

reduction_type

string

可选

减库存方式 0拍下减库存 1付款减库存 2永久不减

dispatch_type

string

可选

运费类型 0包邮 1运费模板 2统一运费

is_commission

string

可选

是否参与分销 0否 1 是

dispatch_express

string

可选

是否支持快递 0否1是

dispatch_intracity

string

可选

是否支持同城配送 0否1是

dispatch_verify

string

可选

是否支持核销 0否1是

weight

string

重量

可选

sales

string

销售量

可选

is_stock_warning

integer

可选

库存预警提醒 0库存正常 1到达库存预警标准

channel_url

object

渠道链接

可选

page

integer

当前页

必需

page_size

integer

每页数量

必需

示例

{
  "error": 0,
  "total": 308,
  "list": [
    {
      "id": "5556",
      "create_time": "2023-02-01 11:33:22",
      "title": "xxxxxxxxx",
      "sub_title": "",
      "short_title": "",
      "type": "0",
      "thumb": "https://likexin-shop.v5dev.getpkg.cn/image/25/2022/10/2dce59ddffaf2ff811694623d1b06697.jpg",
      "thumb_all": [
        "image/25/2022/10/2dce59ddffaf2ff811694623d1b06697.jpg",
        "image/25/2022/10/8cfc4d8a3ff6d5eb6bf3e8a682471d32.jpg",
        "image/25/2022/10/278faa4a03d2ed61227ac97a3fce4101.jpg",
        "image/25/2022/10/2d852eb3b41ab459869672e9f15ca766.jpg",
        "image/25/2022/10/8b6f183063730be495d200a2becdd57d.jpg",
        "image/25/2022/10/253ee13c05181036aa8209bb7682c534.jpg",
        "image/25/2022/10/897280a1013c43ae0ecfa326f1eab332.jpg"
      ],
      "video": "https://v.qq.com/x/page/a1469oslq5t.html",
      "video_thumb": "https://likexin-shop.v5dev.getpkg.cn/image/25/2022/10/cadf96854ad87039e8065416b06cec2c.jpg",
      "unit": "件",
      "goods_code": "",
      "bar_code": "",
      "display_order": "9999",
      "stock": "6012000",
      "stock_warning": "20",
      "real_sales": "0",
      "price": "0.01",
      "min_price": "0.01",
      "max_price": "0.01",
      "cost_price": "0.00",
      "original_price": "220.00",
      "view_count": "73",
      "has_option": "0",
      "is_hot": "1",
      "is_recommand": "1",
      "is_new": "1",
      "status": "1",
      "reduction_type": "0",
      "dispatch_type": "0",
      "is_commission": "0",
      "dispatch_express": "1",
      "dispatch_intracity": "0",
      "dispatch_verify": "0",
      "weight": "0.00",
      "sales": "0",
      "is_stock_warning": 0,
      "channel_url": {
        "wap": "http://alone-mbw.v5dev.getpkg.cn/wap/25/pagesGoods/detail/index?goods_id=5556",
        "wxapp": "/pagesGoods/detail/index.html?goods_id=5556"
      }
    }
  ],
  "page": 1,
  "page_size": 1
}