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

请求头

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

请求参数

Query

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

Body

参数名称	参数类型	是否必传	参数描述
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 : 团购套餐 •3 : 预售券 •4 : 日历房 •5 : 门票 •7 : 旅行跟拍 •8 : 一日游 •11 : 代金券 •14: x项目
- biz_line	int	TRUE	业务线： •1：闭环自研开发者 •3：直连服务商 •5：小程序
- account_name	string	TRUE	商家名
- sold_start_time	int	FALSE	售卖开始时间
- sold_end_time	int	FALSE	售卖结束时间
- out_url	string	FALSE	第三方跳转链接，小程序商品必填
- poi_list	struct	TRUE	店铺列表
-- supplier_ext_id	string	TRUE	接入方店铺id，保存时必传
- attr_key_value_map	map < string,string >	FALSE	商品属性 KV，填写时参考下文「attr_key_value_map 的格式」
sku	SkuStruct	TRUE	售卖单元
- sku_id	string	TRUE	sku id，创建时不必填写
- sku_name	string	TRUE	sku名
- origin_amount	int	TRUE	原价，团购创建时如有commodity属性可不填，会根据菜品搭配计算原价
- 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	FALSE	第三方id
- status	int	TRUE	状态。1：在线；默认传1
- attr_key_value_map	map < string,string >	FALSE	sku属性KV，填写时参考下文「attr_key_value_map的格式」
owner_account_id	string	FALSE	商品归属账户ID，非必传；传入时须与该商家满足商服关系；没有还没有商户ID，可以先不传

请求示例

curl --location --request POST 'https://open.douyin.com/life/goods/product/save/?access_token=clt.xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product": {
        "account_name": "测试商家",
        "attr_key_value_map": {
            "appointment": "{\"need_appointment\":false,\"ahead_day_num\":0}",
            "auto_renew": "false",
            "can_no_use_date": "{\"enable\":false}",
            "environment_image_list": "[{\"url\":\"https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png\"}]",
            "image_list": "[{\"url\":\"https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png\"}]",
            "parking_lot_within_1km": "true",
            "real_name_info": "{\"enable\":false,\"scene\":0}",
            "rec_person_num": "1",
            "show_channel": "1",
            "superimposed_discounts": "true",
            "use_date": "{\"use_date_type\":1,\"use_start_date\":\"2021-12-06\",\"use_end_date\":\"2022-11-30\"}",
            "use_time": "{\"use_time_type\":1}",
            "bring_out_meal": "false",
            "free_pack": "false",
            "Notification": "[]",
            "private_room": "false",
            "rec_person_num_max": "2",
            "RefundPolicy": "1",
            "refund_need_merchant_confirm":"false"
        },
        "biz_line": 5,
        "category_id": 1001001,
        "out_id": "xxx-out-id",
        "poi_list": [
            {
                "supplier_ext_id": "supplier_ext_id_001"
            }
        ],
        "product_name": "测试商品名",
        "product_type": 1,
        "sold_end_time": 1665607528,
        "sold_start_time": 1655607528,
        "telephone": ["1234-4321"]
    },
    "sku": {
        "actual_amount": 1,
        "attr_key_value_map": {
            "code_source_type": "1",
            "commodity": "[{\"group_name\":\"测试\",\"total_count\":1,\"option_count\":1,\"item_list\":[{\"name\":\"你\",\"price\":100,\"count\":1,\"unit\":\"份\"}]}]",
            "limit_rule": "{\"is_limit\":false}",
            "refund_need_merchant_confirm": "false",
            "settle_type": "1",
            "use_type": "1"
        },
        "origin_amount": 100,
        "sku_name": "测试",
        "status": 1,
        "stock": {
            "limit_type": 0,
            "stock_qty": 500
        }
    }
}'

响应参数

参数名称	参数类型	是否必传	参数描述
base	struct	TRUE	公共参数
- log_id	string	TRUE	请求日志ID
- gateway_code	i32	TRUE	网关状态码
- gateway_msg	string	TRUE	网关状态信息
- biz_code	i32	TRUE	业务状态码
- biz_msg	string	TRUE	业务状态信息
data	struct	TRUE	返回数据
- product_id	string		创建/更新商品成功后产生，与老接口spu_id一致