抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
用于查询商品草稿数据列表。

使用限制

接口说明

1、查询本 client_key(或绑定的账号)对应的商品草稿列表。
2、处于审核中、或审核成功、失败的数据可以通过该接口查询到。

基本信息

HTTP URL
https://open.douyin.com/life/goods/product/draft/list/
HTTP Method
GET
Scope
    enterprise.groupon
权限要求
需要权限申请,参考在开发者平台控制台选择行业类目及身份后的入驻指引

请求 Query 参数

参数名称
参数类型
是否必传
参数描述
access_token
string
TRUE
调用/oauth/client_token/生成的token,此token不需要用户授权。
cursor
string
FALSE
第一页不传,之后用前一次返回的next_cursor传入进行翻页
count
int
FALSE
分页数量,不传默认为5
status
int
FALSE
过滤草稿状态,10-审核中 12-审核失败 1-审核通过
请求 cURL 示例
curl --location --request GET 'https://open.douyin.com/life/goods/product/draft/list/?access_token=clt.xxxxx&status=12&count=10'
响应 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
业务状态信息