FAQ
收藏我的收藏
收藏
Q : 已经正确获取到 access_token，在调用一键发布接口时，提示 access_token 过期
A : item_id 是有特殊字符的字符串, 作为 url 参数时, 必须 UrlEncode。
Q : Webhooks 的消息来源验证, 使用秘钥拼接上从流中读取的 json 消息体,使用 sha1 哈希,得到的值和在请求 header 中的 X-Douyin-Signature 中的值不一致
A : json 序列化的方式是使用 json-iterator。有个 featrure 是最后会带一个换行符
Q : 查询指定视频数据 需要 video.data 这项权限，可是在后台里好像没有这个 scope。如何申请？
A : 目前开放的接口在快速增加，可能出现功能上线，但申请入口没有放在管理中心的情况。可以发邮件到 feedback-openplatform@douyin.com 进行申请。
Q : 我用一键发布接口发 mkv 格式的，支持么
A : 主流都是支持的，你可以测试一次
Q : 应用授权用户数量有限制？
A : 目前没有限制
Q : quota 是什么？
A：quota 意为配额，是对 OpenApi 接口调用的次数限制。
目前 quota 清零的周期为 24 小时，即每天更新。
quota 的消耗维度为 scope，举例来说：
接口 a 和接口 b 所关联 scope 均为 S，若某个 clientKey 经过用户授权后通过 accessToken 分别调用一次接口 a 和接口 b，则该 clientKey 在 scope S 下的 quota 消耗两个单位。
开发者可在「管理中心」查看应用的 quota 余量，当日 quota 用完时，可申请提额。
Q : 测试应用为什么封禁了？
A：测试应用满 120 天不上线会自动封禁，无法使用，建议用户重新申请应用。
Q : trial.whitelist 权限应该怎么获得？
类似问题：
- 用户未绑定应用白名单，如何获取白名单权限？
- 白名单的状态为待绑定，需要怎么操作才能变成已绑定？
- 应用设置添加了白名单，状态是待绑定，如何绑定？
- 手机扫描提示 用户未绑定应用白名单，请授权 trial.whitelist 权限
A：在管理中心，应用详情的 scope 列，添加 trial.whitelist （特殊权限栏下）权限和 user_info（用户权限栏下）权限，一起让该用户授权即可。
Q : 开放平台里申请了白名单用户一直显示待绑定
类似问题：
- 扫码获取授权code提示未绑定应用白名单
- 用户扫码获取授权码code提示用户未绑定应用白名单，请授权trial.whitelist权限
- 应用后台添加预览白名单，输入抖音号之后，状态一直都说待绑定状态的
A：需要在 scope 中添加 trial.whitelist 权限和 user_info 一起让该用户授权即可。
Q : 测试应用无法使用白名单，该怎样处理？
类似问题：
- 测试应用无法添加白名单测试
- 用户未绑定应用白名单，请授权 trial.whitelist 权限
- 测试应用绑定白名单后，抖音号没有收到授权提示
- 跳转测试应用，账号提示未加入白名单
- 测试应用如何绑定白名单？
- 测试应用，西瓜头条无法绑定白名单
- 测试应用绑定白名单，添加了抖音号，一直提示未绑定
- 测试环境白名单已配置，用户授权报错
A：测试应用转成正式应用才能使用这个 trial.whitelist 添加白名单，扫码体验。
Q : 校验 webhook 回调地址，如何返回信息？
类似问题：
- 抖音通过webhook发送通知给我后，我需要给什么回执抖音才认为成功了呢？
A：
把整个 content 全部返回就可以，返回内容需要放入 ResponseBody 里,不能直接返回；并且返回内容为 text 格式的 json 数据。详见：https://developer.open-douyin.com/docs/resource/zh-CN/dop/develop/webhooks/summarize开放平台发送的验证请求示例:
{ "event": "verify_webhook", "client_key": "", "content": { "challenge": 12345 } }
当你收到开放平台 POST 验证请求时，你需要解析出 challenge 值，并立即返回该 challenge 值作为响应。
需要注意：返回内容需要放入 ResponseBody 里,不能直接返回；并且返回内容为 text 格式的 json 数据。
{ "challenge": 12345 }
