抖音开放平台Logo
开发者文档
控制台
同步库存​

使用限制

无​

接口说明

1、小程序商品使用,非小程序商品可忽略此接口​

基本信息

HTTP URL​
HTTP Method​
POST​
申请权限​
商品发布​
权限要求​
    需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案​
    需要商家授权,路径:抖音来客>店铺管理>第三方应用授权​

请求头

参数
描述
必须
Content-Type​
application/json​
是​
access-token​
根据这个地址获取的token​
是​

请求参数

Body 请求

参数名称
参数类型
是否必传
参数描述
    product_id​
string​
FALSE​
商品id​
product_id 和out_id 字段须二选一​
    out_id​
string​
FALSE​
商品第三方id​
product_id 和out_id 字段须二选一​
    stock​
StockStruct​
TRUE​
库存信息​
    limit_type​
int​
TRUE​
库存上限类型,为2时stock_qty字段无意义 1-有限库存 2-无限库存​
    stock_qty​
int​
TRUE​
总库存,limit_type=2时无意义​
    account_id​
string​
TURE​
商家ID,传入时服务商须与该商家满足授权关系​

请求示例

curl --location 'https://open.douyin.com/goodlife/v1/akte/goods/stock/sync/' \ --header 'access-token: clt.fbf20fbdd88a69ef7e52bf7c953b2d94aJghqCfoYQJsiuCM43y9f8dK9Pmh' \ --header 'Content-Type: application/json' \ --header 'Cookie: passport_csrf_token=07a8ffb6d249f30aaacb663c962296d4; passport_csrf_token_default=07a8ffb6d249f30aaacb663c962296d4' \ --data '{ "out_id": "akte_goods_demo", "stock": { "limit_type": 1, "stock_qty": 800 }, "account_id": "7166966001467131917" }'

响应参数

参数名称
参数类型
是否必传
参数描述
    data
struct
TRUE
响应信息
    error_code​
int​
TRUE​
错误码​
    description​
string​
TRUE​
错误描述​
    extra
struct
TRUE
响应额外信息
    error_code​
int​
TRUE​
错误码​
    description​
string​
TRUE​
错误描述​
    sub_error_code​
int​
TRUE​
(弃用)子错误码​
    sub_description​
string​
TRUE​
(弃用)子错误描述​
    now​
int​
TRUE​
(弃用)时间戳​
    logid​
string​
TRUE​
请求日志ID​
    data
struct
TRUE
响应信息
    error_code​
int​
TRUE​
错误码​
    description​
string​
TRUE​
错误描述​

响应示例

正常示例

{ "data": { "error_code": 0, "description": "success" }, "extra": { "error_code": 0, "description": "success", "sub_error_code": 0, "sub_description": "", "logid": "xxx", "now": 1651113600 } }

错误码

HTTP 状态码
错误码
错误消息
排查建议
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​
联系抖音处理​