抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

用于创建多 SKU 商品。

使用限制

接口说明

1、创建团购活动列表
2、团购/代金券不用对接这个接口

基本信息

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

请求头

参数
描述
必须
Content-Type
application/json

请求 Query 参数

参数名称
参数类型
是否必传
参数描述
access_token
string
TRUE
调用/oauth/client_token/生成的token,此token不需要用户授权。

请求 Body 参数

参数名称
参数类型
是否必传
参数描述
product_id
string
FALSE
商品id
out_id
string
FALSE
商品外部id
sku_list
list < SkuStruct >
FALSE
SKU列表
- 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时无意义
- out_sku_id
string
TRUE
第三方id
- status
int
TRUE
状态 1-在线 -1-删除
- attr_key_value_map
map < string,string >
FALSE
sku属性KV

请求 cURL 示例

curl --location --request POST 'https://open.douyin.com/life/goods/sku/batch_save/?access_token=clt.39b7626b0b59fd8dacf9979ddcd4f532wIbkKJ8NIDKeANyibUlKvAk1Ryi5' \ --header 'Content-Type: application/json' \ --header 'Cookie: passport_csrf_token=c668eb94b8bbe65a0b452466d06e329b; passport_csrf_token_default=c668eb94b8bbe65a0b452466d06e329b' \ --data-raw '{ "out_id": "hch-life-0314-rl03", "sku_list": [ { "actual_amount": 1, "attr_key_value_map": { "Date": "20220423" }, "origin_amount": 100, "sku_name": "20220423", "status": 1, "stock": { "limit_type": 0, "stock_qty": 500 } }, { "actual_amount": 1, "attr_key_value_map": { "Date": "20220524" }, "origin_amount": 100, "sku_name": "20220524", "status": 1, "stock": { "limit_type": 0, "stock_qty": 500 } } ] }'

响应 Body 参数

参数名称
参数类型
是否必传
参数描述
base
struct
TRUE
公共参数
- log_id
string
TRUE
请求日志ID
- gateway_code
int
TRUE
网关状态码
- gateway_msg
string
TRUE
网关状态信息
- biz_code
int
TRUE
业务状态码
- biz_msg
string
TRUE
业务状态信息