抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 创建/更新商品接口
  • 免审修改商品接口
  • 上下架商品
  • 同步库存
  • 创建/更新多SKU商品的SKU列表
  • 创建适用人群
  • 商品状态变更通知
  • 代运营
  • 团购退款
  • 商品查询
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 上下架商品

    收藏
    我的收藏
    上下架商品。​

    使用限制

    无​

    接口说明

    无​

    基本信息

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

    请求头

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

    请求参数

    Body 请求

    参数名称
    参数类型
    是否必传
    参数描述
    product_id​
    string​
    FALSE​
    商品id(若有第三方id可不传)​
    out_id​
    string​
    FALSE​
    商品第三方id​
    op_type​
    int64​
    TRUE​
    1-上线 2-下线​
    account_id​
    string​
    TRUE​
    商家ID,传入时服务商须与该商家满足授权关系​

    请求示例

    { "out_id": "hch-life-0314-ms02", "op_type": 2, "account_id": 123123123 }

    响应参数

    参数名称
    参数类型
    是否必传
    参数描述
    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": 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
    联系抖音处理