抖音开放平台Logo
开发者文档
控制台

接口说明

暂无

基本信息

名称描述
HTTP URL
https://open.douyin.com/goodlife/v1/akte/goods/sku/batch_save/
HTTP Method
POST
Scope
life.capacity.goods.found
权限要求
多SKU商品创建/更新SKU列表

请求参数

请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body展开全部子属性
skus必填List
sku列表
展开子属性
account_idString
BaseStruct
展开子属性
product_idString
示例:dsfadfasdf-123rdfadsf
商品Id,与out_id二选一
product_out_idString
商品外部id,与product_id二选一
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/akte/goods/sku/batch_save/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"skus":[{"stock":{"sold_count":2851046986857951707,"limit_type":1,"stock_qty":40450319571360740,"avail_qty":6787399718635453105,"frozen_qty":160085172586652314,"sold_qty":4483989849998086361},"create_time":4309360765126827527,"status":1,"out_sku_id":"mi3DfH7qZb","update_time":4863267813546136541,"sku_name":"Nr4xv4O3Cv","extra":"FkyI8qCFjF","attr_key_value_map":{"Qs8av3tOw6":"FVhLJ3iEDT"},"origin_amount":5278349587251133368,"bind_skus":["hduvcSarJf"],"sku_ext":{"takeaway_presale_info":{"takeaway_presale_product_id":7299179156760777479,"takeaway_presale_sku_id":9042870619018693885}},"sku_id":"dsfadfasdf-123rdfadsf","actual_amount":8656385180793091456}],"account_id":"SBVlpgSm98","Base":{"LogID":"YUCMGySecD","Caller":"eEiKy0DZCg","Addr":"rvpnGo94dZ","Client":"pQtMUSXDEE","TrafficEnv":{"Open":false,"Env":"Ob7pVaEOrQ"},"Extra":{"LuNKERZ6JW":"tmFmXaA2Le"}},"product_id":"dsfadfasdf-123rdfadsf","product_out_id":"pRjY04rXbN"}'

响应参数

Body展开全部子属性
BaseResp必填Struct
展开子属性
dataStruct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 8187356220106354000, "description": "wL4conEfyu", "sub_error_code": 4361388834932556000, "sub_description": "bA9XAWqfl4", "logid": "202008121419360101980821035705926A", "now": 4857760124592656000 }, "BaseResp": { "Extra": { "1PyCcVMFtv": "gPVvBVzNpu" }, "StatusMessage": "IK37AS2ps5", "StatusCode": 76046087180289600 }, "data": { "sku_ids": { "6cdCwJmhII": "CeQYcznojQ" }, "sku_id_list": [ 5752277679919209000 ], "error_code": 5609356674722731000, "description": "2xkorJTLod" } }

错误码

HTTP 状态码错误码错误码描述排查建议
2002100001
未知错误
重试接口,重试3次仍报错联系抖音生活服务技术支持
2002100004
系统繁忙,此时请开发者稍候再试
重试接口,重试3次仍报错联系抖音生活服务技术支持
2002100005
参数不合法
更换参数
2002190002
access_token无效
调用接口重新生成access_token
2002190004
应用未获得该能力, 请去https://open.douyin.com/申请
应用申请接口权限
2002190008
access_token过期,请刷新或重新授权
规范token刷新机制,检查是否有测试环境在同步刷新token
2002119001
参数不合法
更换参数
2002119002
系统繁忙,请稍候再试
重试
2002119003
请求太过频繁,请稍后再试
重试
2002119005
应用未获商家授权
联系合作商家在商家后台发起授权,并在服务商后台同意授权
2003000001
根据实际业务错误返回
对照接口文档规范参数并重试
2004000001
根据实际业务错误返回
补充参数
2004000002
根据实际业务错误返回
对照接口文档规范参数并重试
2005000001
根据实际业务错误返回
联系抖音处理
2005000001
服务器打瞌睡了,请稍后再试。
2003000001
以实际错误信息为准