门店商品列表 - 人人商城V5开放接口

请求参数

Query 参数

chain_shop_id

integer

必需

连锁门店的门店id，获取门店商品列表时必填，仅返回可用的商品（上架，有库存，已分配给门店）

示例值:

307

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

获取商品列表条数

可选

示例值:

示例代码

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 {39}]

商品列表

必需

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_warning

string

可选

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

real_sales

string

实际销售量

可选

status

string

可选

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

allot_status

string

可选

是否分配给门店 0未分配 1已分配

stock

string

商品库存

可选

price

string

商品价格

可选

min_price

string

最低销售价

可选

max_price

string

最高销售价

可选

sales

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是

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

重量

可选

is_stock_warning

integer

可选

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

channel_url

object

渠道链接

可选

page

integer

当前页

必需

page_size

integer

每页数量

必需

示例

成功示例异常示例

{
  "error": 0,
  "total": 1,
  "list": [
    {
      "id": "1968",
      "create_time": "2022-10-14 10:06:51",
      "title": "副本-门店快递商品",
      "sub_title": "",
      "short_title": "",
      "type": "0",
      "thumb": "https://sdshz.oss-cn-qingdao.aliyuncs.com/image/25/2022/10/20ac549290b5f353d8d6e5dec3d14b54.jpg",
      "thumb_all": [
        "image/25/2022/10/20ac549290b5f353d8d6e5dec3d14b54.jpg"
      ],
      "video": "",
      "video_thumb": "",
      "unit": "件",
      "goods_code": "",
      "bar_code": "",
      "display_order": "0",
      "stock_warning": "100",
      "real_sales": "0",
      "status": "1",
      "allot_status": "1",
      "stock": "217",
      "price": "100.00",
      "min_price": "100.00",
      "max_price": "100.00",
      "sales": "5",
      "cost_price": "0.00",
      "original_price": "0.00",
      "view_count": "130",
      "has_option": "0",
      "is_hot": "1",
      "is_recommand": "1",
      "is_new": "1",
      "reduction_type": "0",
      "dispatch_type": "1",
      "is_commission": "0",
      "dispatch_express": "1",
      "dispatch_intracity": "0",
      "dispatch_verify": "1",
      "weight": "0.00",
      "is_stock_warning": 0,
      "channel_url": {
        "wap": "http://alone-uat.v5dev.getpkg.cn/wap/25/pagesGoods/detail/index?goods_id=1968",
        "wxapp": "/pagesGoods/detail/index.html?goods_id=1968"
      }
    }
  ],
  "page": 1,
  "page_size": 20
}