抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

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

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

使用范围

    •SDK
    •企业号
    •生活服务

通用状态码(新)

说明:抖音开放平台对通用错误码进行了升级和更新,新能力的通用错误码参考可下列表格:
错误码
含义
排查建议
0
成功
​
28001005
系统繁忙,此时请开发者稍候再试
请求重试,若依然无解请向平台提交反馈
28001006
网络调用错误,请重试
请求重试,若依然无解请向平台提交反馈
28001007
参数不合法
根据错误信息检查请求参数是否填写正常
28001008
access_token过期,请刷新或重新授权
重新请求生成access_token并确保access_token有效
28001012
用户未授权该OpenAPI
接入授权SDK,获取含对应scope的access_token进行OpenAPI调用
28001014
应用未授权任何能力
28001015
请求参数 access_token 和 openId不匹配
检查参数的open_id和access_token是否为同一用户
28001016
当前应用已被封禁或下线
应用不可用,联系平台处理
28001017
未知URI
能力内部异常,联系平台处理
28001018
应用未获得该能力
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/ 申请
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
您的素材数量已达上限
​