抖音开放平台Logo
开发者文档
移动/网站应用
控制台
  • OpenAPI 列表
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 互动评论
  • 搜索能力
  • 私信群聊
  • 企业号开放能力（内测结束暂不开放）
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权

    • 状态码排查工具
    收藏
    我的收藏

    OpenAPI 接口的状态码查询，可直接进入状态码排查工具。

    使用范围

      •SDK
      •企业号
      •生活服务

    通用状态码(新)

    说明：抖音开放平台对通用错误码进行了升级和更新，新能力的通用错误码参考可下列表格：
    错误码
    含义
    排查建议
    0
    成功
    ​
    28001005
    系统繁忙，此时请开发者稍候再试
    请求重试，若依然无解请向平台提交反馈
    28001006
    网络调用错误，请重试
    请求重试，若依然无解请向平台提交反馈
    28001007
    参数不合法
    根据错误信息检查请求参数是否填写正常
    28001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token并确保access_token有效
    28001012
    用户未授权该OpenAPI
    接入授权SDK，获取含对应scope的access_token进行OpenAPI调用
    28001014
    应用未授权任何能力
    请去 https://open.douyin.com/ 申请
    28001015
    请求参数 access_token 和 openId不匹配
    检查参数的open_id和access_token是否为同一用户
    28001016
    当前应用已被封禁或下线
    应用不可用，联系平台处理
    28001017
    未知URI
    能力内部异常，联系平台处理
    28001018
    应用未获得该能力
    请去 https://open.douyin.com/ 申请
    28001019
    当前能力已被封禁或下线
    该能力被封禁，联系平台处理
    28001020
    用户未绑定该测试应用
    参考「测试应用及权限常见问题」进行用户绑定
    28001021
    测试应用已过期
    参考「测试应用及权限常见问题」进行应用转正
    28001042
    isv_token无此scope权限
    重新生成isv_token，确保isv_token有对应scope权限
    28001045
    用户已注销，因此无法授权或调用该Scope
    该用户为注销用户，数据不支持查询，如有疑问联系平台处理
    28001046
    用户已被封禁，因此无法授权或调用该Scope
    该用户为封禁用户，数据不支持查询，如有疑问联系平台处理
    28001047
    用户为私密用户，因此无法授权或调用该Scope
    该用户为私密用户，数据不支持查询，如有疑问联系平台处理
    28001052
    获取平台能力存在异常风险，请稍后再试
    获取数据存在风险，控制访问频率。
    28001056
    该能力API已下线，不再支持调用
    该能力被下线，联系平台处理
    28003017
    quota 已用完
    应用能力可调用额度不足，请去 https://open.douyin.com/ 提额
    28003018
    请求频率过高
    控制接口请求频率，如需增加限流值联系平台处理
    28004020
    本次授权中存在授权该授权场景不支持的 scope
    如有疑问联系平台处理

    通用状态码(旧）

    说明：抖音开放平台通用错误码升级和更新前的状态码，部分历史能力的通用错误码可参考下列表格：
    错误码
    含义
    排查建议
    0
    成功
    ​
    2100004
    系统繁忙，此时请开发者稍候再试
    请求重试，若依然无解请向平台提交反馈
    2100005
    参数不合法
    根据错误信息检查请求参数是否填写正常
    2100007
    无权限操作
    权限不足，联系平台处理
    2100009
    用户被禁封使用该操作
    用户异常，数据不支持查询，如有疑问联系平台处理
    2190001
    quota 已用完
    应用能力可调用额度不足，请去 https://open.douyin.com/ 提额
    2190003
    用户未授权该api
    接入授权SDK，获取含对应scope的access_token进行OpenAPI调用
    2190004
    应用未获得该能力, 请去 https://open.douyin.com/ 申请
    请去https://open.douyin.com/申请"
    2190015
    请求参数 access_token 和 openId不匹配
    检查参数的open_id和access_token是否为同一用户
    2190016
    当前应用已被封禁或下线
    应用不可用，联系平台处理
    2190017
    测试应用已过期
    参考「测试应用及权限常见问题」进行应用转正
    2190018
    用户未绑定该测试应用
    参考「测试应用及权限常见问题」进行用户绑定
    2190019
    当前能力已被封禁或下线
    该能力被封禁，联系平台处理
    2190020
    请求频率过高
    控制接口请求频率，如需增加限流值联系平台处理
    ​

    Oauth2 状态码

    错误码
    含义
    10002
    参数错误
    10003
    client_key 错误
    10004
    应用权限不足，请申请对应的 scope 权限
    10005
    缺少参数
    10006
    非法重定向 URI，需要与 App 配置中的"授权回调域"一致。
    10007
    授权码过期
    10008
    access_token 无效或过期
    10010
    refresh_token 无效或过期
    10011
    应用包名与配置不一致
    10012
    应用正在审核中，无法进行授权
    10013
    client_key 或者 client_secret 错误
    10014
    授权的 client_key 与获取 access_token 时传递的 client_key 不一致
    10015
    应用类型错误，如将 app 应用的 client_key 用于 PC 应用
    10017
    安卓应用签名与配置不一致，请检查签名信息
    10020
    更新 refresh_token 次数超出限制
    2190002
    access_token 无效
    2190003
    用户未授权该 API
    2190008
    access_token 过期,请刷新或重新授权

    视频状态码

    错误码
    含义
    2190005
    视频文件太大了
    2190006
    视频时长不能超过 15 分钟
    2190007
    无效的视频文件 ID
    2114005
    视频投稿功能已封禁，详情见抖音端上【消息-系统通知】
    2114007
    视频发布数量超过每日上限

    视频评论状态码

    错误码
    含义
    2111001
    命中敏感词
    2111002
    获取评论失败
    2111003
    无效的评论
    2111004
    非本视频评论
    2111005
    上一个置顶评论正在审核中, 请稍后再试
    2111006
    评论失败
    2111007
    获取视频失败

    企业号

    错误码
    含义
    2112001
    非企业号用户

    素材库

    错误码
    含义
    2113001
    素材不符合要求, 未通过审核
    2113002
    您的素材数量已达上限
    ​