查询商品草稿数据列表

开发环境

http://dev-cn.your-api-server.com

GET

/life/goods/product/draft/list/

接口说明

1、查询本 client_key（或绑定的账号）对应的商品草稿列表。

2、处于审核中、或审核成功、失败的数据可以通过该接口查询到。
权限要求

需要权限申请，参考在开发者平台控制台选择行业类目及身份后的入驻指引。

响应 Body 参数

参数名称	参数类型	是否必传	参数描述
data	struct	TRUE	业务参数
- next_cursor	string	TRUE	用于查询下一页
- has_more	bool	TRUE	是否有下一页
- product_list	list < ProductDraft >	TRUE	草稿列表
-- draft_status	int	TRUE	草稿状态 10-审核中 12-审核失败 1-审核通过 11-审核通过（老库存量数据,新接口保存后擦除）
-- product	ProductStruct	TRUE	商品
--- product_id	string	TRUE	商品Id，创建时不必填写，更新时如有out_id可不填写
--- out_id	string	TRUE	外部商品id
--- product_name	string	TRUE	商品名
--- category_full_name	string	TRUE	品类全名，保存时不必填写
--- category_id	int	TRUE	品类id
--- product_type	int	TRUE	商品类型 1-团购 11-代金券
--- biz_line	int	TRUE	业务线 1-闭环自研开发者 3-直连服务商 5-小程序
--- account_name	string	TRUE	商家名
--- sold_start_time	int	FALSE	售卖开始时间
--- sold_end_time	int	FALSE	售卖结束时间
--- create_time	int	FALSE	创建时间，保存时不必填写
--- update_time	int	FALSE	更新时间，保存时不必填写
--- out_url	string	FALSE	第三方跳转链接，小程序商品必填
--- poi_list	list < PoiStruct >	TRUE	店铺列表
---- supplier_ext_id	string	TRUE	接入方店铺id，保存时必传
---- poi_id	int	FALSE	poi id，保存时不必填写
---- supplier_id	int	FALSE	店铺id，保存时不必填写
--- attr_key_value_map	map < string,string >	FALSE	商品属性KV
-- sku	string	TRUE	售卖单元
--- sku_id	string	TRUE	sku id，创建时不必填写
--- sku_name	string	TRUE	sku名
--- origin_amount	int	TRUE	原价，团购创建时可不填，会根据商品搭配计算原价
--- actual_amount	int	TRUE	实际支付价格
--- stock	StockStruct	TRUE	库存信息
---- limit_type	int	TRUE	库存上限类型，为2时stock_qty和avail_qty字段无意义 1-有限库存 2-无限库存
---- stock_qty	int	TRUE	总库存，limit_type=2时无意义
---- avail_qty	int	TRUE	可用库存，limit_type=2时无意义，始终保证stock_qty=avail_qty+frozen_qty+sold_qty
---- frozen_qty	int	TRUE	冻结库存，保存SKU时不填
---- sold_qty	int	TRUE	售卖库存, 退款回滚，保存SKU时不填
---- sold_count	int	TRUE	销量，退款不回滚，保存SKU时不填
--- out_sku_id	string	TRUE	第三方id
--- status	int	TRUE	状态 1-在线 -1-删除
base	struct	TRUE	公共参数
- log_id	string	TRUE	请求日志ID
- gateway_code	int	TRUE	网关状态码
- gateway_msg	string	TRUE	网关状态信息
- biz_code	int	TRUE	业务状态码
- biz_msg	string	TRUE	业务状态信息

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/life/goods/product/draft/list/?access_token=clt.xxxxx&status=12&count=10'

响应示例

{}

请求参数

Query 参数

access_token

string

必需

调用/oauth/client_token/生成的token，此token不需要用户授权。

示例值:

clt.xxxxx

status

string

可选

过滤草稿状态，10-审核中 12-审核失败 1-审核通过

示例值:

12

count

string

可选

分页数量，不传默认为5

示例值:

10

返回响应

🟢200成功

application/json

Body

object {0}

查询商品线上数据列表

用于创建多 SKU 商品。