抖音开放平台Logo
开发者文档
控制台
上下架商品。​

使用限制

无​

接口说明

无​

基本信息

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

请求头

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

请求参数

Body 请求

参数名称
参数类型
是否必传
参数描述
product_id​
string​
FALSE​
商品id (商品id或商品外部id 须选其一)​
out_id​
string​
FALSE​
商品外部id (商品id或商品外部id 须选其一)​
op_type​
int64​
TRUE​
1-上线 2-下线​
account_id​
string​
TRUE​
商品归属商家ID,传入时服务商须与该商家满足授权关系​

请求示例

curl --location 'https://open.douyin.com/goodlife/v1/akte/goods/product/operate/?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", "op_type": 2, "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": { "error_code": 0, "description": "success" }, "extra": { "error_code": 0, "description": "success", "sub_error_code": 0, "sub_description": "", "logid": "xxx", "now": 1698302959 } }

错误码

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​
联系抖音处理​