创建/更新商品接口
收藏
我的收藏用于创建和修改商品。
接口说明
- 创建或更新商品。
- 2.对于同一服务商,相同的out_id会被认为是同一商品,重复创建会被覆盖(相当于修改)。
- 3.商品和SKU属性字段(attr_key_value_map ),需要通过【查询商品模板接口】(https://developer.open-douyin.com/docs/resource/zh-CN/local-life/develop/OpenAPI/general-capabilities/product-query/template.get)获取
- 4.新增商品二级类型参数 product_sub_type (仅小程序酒旅预售应用)
- 5.创建商品时设置金额与前端用户侧展示关系,见下图。
- 5.顺序:先上预订商品,再上预售商品,上预售商品时通过 bind_skus 字段关联。
- 6.注意:如果预售券为多预订商品多门店的通兑券,则需要在 bind_skus 中绑定多门店的预订商品,且在 pois(适用门店)字段中传入对应预订商品所属的 POI_IDs。
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/goodlife/v1/goods/product/save/ |
HTTP Method | POST |
Scope | life.capacity.goods.found |
权限要求 | 商品发布 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body展开全部子属性
product必填Struct
展开子属性
account_idString
商家id
BaseStruct
展开子属性
skuStruct
单sku商品必传;多sku商品不传,需要单独通过sku接口保存
展开子属性
skusList
展开子属性
请求示例
{ "account_id": "7113893944009705516", "product": { "account_name": "lh测试商家", "attr_key_value_map": { "appointment": "{\"need_appointment\":true, \"ahead_time_type\":2, \"ahead_hour_num\":5,\"external_link\":\"urlxxx\", \"order_appointment_time_url\":\"urlxxx\"}", "auto_renew": "true", "bring_out_meal": "false", "can_no_use_date": "{\"enable\": true,\"days_of_week\": [7, 1, 2, 3, 4],\"holidays\": [1, 2, 3, 4, 5],\"date_list\": [\"2022-03-08\", \"2022-03-09\"],\"holiday_dates\": {\"1\": \"2022.01.01-2022.01.03\"}}", "customer_reserved_info": "{\"allow\":false}", "description_rich_text": "[{\"note_type\":1,\"content\":\"其他说明信息-美食团购\"}]", "detail_image_list": "[{\"url\":\"https://aweme-upload-image/7038504987084734508..png\"}]", "dishes_image_list": "[{\"url\":\"https://aweme-upload-image/7038504987084734508.png\"}]", "environment_image_list": "[{\"url\":\"https://aweme-upload-image/7038504987084734508.png\"}]", "free_pack": "true", "FrontCategoryTag": "[\"美食套餐\"]", "image_list": "[{\"url\":\"https://aweme-upload-image/7038505021658382380.png\"},{\"url\":\"https://aweme-upload-image/7038505050439696428.png\"}]", "IndustryType": "其他", "IsConfirmImme": "true", "Notification": "[{\"title\":\"标题\",\"content\":\"内容美食1.1\"}]", "private_room": "true", "real_name_info": "{\"enable\":false,\"scene\":0}", "RecommendWord": "推荐语", "rec_person_num": "99", "rec_person_num_max": "999", "RefundPolicy": "2", "refund_need_merchant_confirm": "true", "show_channel": "2", "SortWeight": "0", "superimposed_discounts": "true", "TagList": "标签列表-待填写", "use_date": "{\"use_date_type\":1,\"use_start_date\":\"2021-12-06\",\"use_end_date\":\"2033-03-03\"}", "use_time": "{\"use_time_type\":1}", "account_name": "lh测试商家", "poi_list": "[{\"poi_id\": \"123123123123\"}]", "product_name": "migrate_openapi_0711_01", "sold_start_time": "1646724999", "sold_end_time": "1745607528" }, "biz_line": 1, "category_id": 1001001, "out_id": "migrate_openapi_0711_03", "pois": [ { "poi_id": "123123123123" } ], "product_name": "migrate_openapi_0711_03", "product_type": 1, "sold_end_time": 1745607528, "sold_start_time": 1646724999, "telephone": ["1234-4321"] }, "sku": { "actual_amount": 996, "attr_key_value_map": { "code_source_type": "1", "commodity": "[{\"group_name\":\"测试0001\",\"total_count\":1,\"option_count\":1,\"item_list\":[{\"name\":\"可乐\",\"price\":1998,\"count\":1,\"unit\":\"份\"}]}]", "limit_rule": "{\"is_limit\":true,\"total_buy_num\":9}", "market_price": "900", "settle_type": "1", "use_type": "1", "stock_info": "{\"limit_type\": 1,\"stock_qty\": 500}" }, "origin_amount": 1399, "sku_name": "测试", "status": 1, "stock": { "limit_type": 1, "stock_qty": 500 } } }
响应参数
Body展开全部子属性
BaseResp必填Struct
展开子属性
dataStruct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "error_code": 0, "description": "success", "product_id": "111" }, "extra": { "error_code": 0, "description": "success", "sub_error_code": 0, "sub_description": "", "logid": "xxx", "now": 1651113600 } }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100005 | 参数不合法 | 更换参数 |
200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
200 | 2119001 | 参数不合法 | 更换参数 |
200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
200 | 2137000328 | 当前商品归属账户-%v,和门店无认领或使用关系,确认入参信息或者绑定账户和门店的关系,添加门店失败数量为:%d, 失败门店ID为:%s | 检查失败门店是否被认领,更换门店相关参数 |
200 | 5000001 | 服务器打瞌睡了,请稍后再试。 | |
200 | 3000001 | 以实际错误信息为准 |
点击纠错