抖音开放平台Logo
开发者文档
小程序
控制台
  • OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 搜索能力
  • 订阅消息
  • 挂载
  • 分发
  • 私信和群聊
  • 群聊管理
  • 经营工具
  • 私信管理
  • 私域经营常见问题
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
      • • Command + F 进行问题关键字搜索
      •若文档无法解决问题，请通过工单系统进行技术咨询

    接入相关

    BusinessToken, AccessToken, ClientToken 概念

    ​
    business_token
    biz_refresh_token
    access_token
    refresh_token
    client_access_token/client_token
    概念
    经营关系调用凭证，可用于调用用户授权相关的 OpenAPI
    经营关系 Token 续期凭证
    ​
    调用用户授权相关的 OpenAPI调用凭证
    通过 /oauth/access_token/ 接口获取
    获取新 access_token 的续期凭证
    调用非用户授权相关的 OpenApi 调用凭证
    通过 /oauth/client_token/ 接口获取
    有效期
    30d
    长期有效
    15d
    30d
    2h
    续期
    通过 /oauth/refresh_biz_token/ 接口，获取一个新的Token。或者通过business_token生成接口签发一个新的经营Token
    ​
    ​
    通过 /oauth/refresh_token/接口，获取一个新 token，或者将旧 token 有效期延长到15d；
    ​
    可以通过renew_refresh_token接口续期5次；
    特殊需求下，可以配置每次调用 refresh_token 接口都会延长 refresh_token 本身的有效期到30d；
    ​
    无续期逻辑
    失效逻辑
      •有效期到期后没有续期
      •有效期到期后没有续期
      •有效期到期后没有续期
      •用户主动解除授权
    ​
      •有效期到期后没有续期
    ​
      •应用首次授权生成 tokenA，有效期2小时
      •重新进行授权，生成 tokenB，有效期2小时，tokenA有效期变为5分钟
      •再次进行授权，生成 tokenC，有效期两小时，tokenB 有限期变为5分钟，tokenA失效
    ​

    经营能力、用户授权、非用户授权的接口调用区别 ？

    抖音开放平台提供的能力以是否读写用户数据为标准可以划分为两类。
      •不操作用户数据的能力称作非用户授权能力，调用时仅需要通过client_token证明调用方的合法身份即可。
      •需要操作用户数据的能力，又以用户身份为标准可以划分为面向B端用户的经营能力，与面向C端普通用户的用户授权能力。
      ▪经营能力面向于抖音生态内参与各种经营活动的各种用户，经营关系在平台进行登记授权后，可以通过BusinessToken调用对应能力。
      ▪用户授权能力面向于普通用户，需要用户显式进行授权确认，并有较强的时效性确保用户定期检查自己的授权情况。开发者可以在完成用户授权后，使用 AccessToken 调用相应能力。
    各种 Token 的概念与获取方式详见上文。
    ​

    不同应用的 OpenID 如何互换 ？

    详见联合授权获取用户标识能力
    ​

    小程序 schema 的获取方式

      1.通过接口生成 Generate，通过 expire_time 参数控制过期时间，链接过期后需重新生成
      2.在小程序界面点击右上角 ... > 分享 > 复制链接，链接有效时间为 45 天，链接过期后需重新生成
    ​

    能力报错

    调用创建小程序引导卡片接口 api/douyin/v1/im/set_applet_template/ 返回相同 template_id

    接口存在防重复提交机制，应用多次调用接口传入相同的 content, media_id,title,app_id 参数创建小程序引导卡片，接口会返回相同的 card_template_id。
    ​

    调用接口报错 access_token无效，错误码 28001003

    自查 CheckList：
      1.确认接口文档明确该接口是否需要授权，以及是否传入了对应的 access_token / client_token / biz_token
      ▪若在需要授权的接口中传入 client_token 或反之都会出现此报错
      2.确认传入的 access_token / client_token 是否与获得的 token 一致
      3.确认 access_token / client_token 处于有效期内
    ​
    若自查项均通过，请通过工单系统进行咨询。
    ​

    调用接口报错 xxx must have a value，错误码 28001007

    自查 CheckList：
      1.确认接口文档中相关参数位置，是在 Query、Body 还是 Header 中
      2.确认相关参数拼写是否符合预期
    ​
    若自查项均通过，请通过工单系统进行咨询。
    ​

    调用接口报错参数不合法，错误码 2100005

    自查 CheckList：
      •确认传入参数是否与 app_id 对应，如小程序卡片模板 id 与 app_id 存在对应关系
      •若通过 query 传入参数，确认参数是否已经 URL Encode
      •...
    ​

    未收到相关事件 Webhook

    自查 CheckList：
      1.是否已按需申请事件相关 scope 权限
      2.检查应用是否已经订阅相关事件 webhook
    小程序
    移动 / 网站应用
    ​
      3.(若事件需要用户授权) 确认用户已经授权了相关 scope
      i.用户点击的授权页中，存在相关 scope 且该能力处于勾选状态
      ii.已完整走完授权流程，获取到 access_token / business_token
      iii.授权用户可以在 抖音-设置-账号与安全-授权管理 中查看相关授权能力
      4.若仍无法接受到相关 webhook，请提供相关事件的触发时机、内容，通过工单系统进行咨询
    ​

    Webhook 消息延迟

    抖音开放平台 Webhook 能力存在重试机制，会在 12 小时内进行退避重试。
    若出现频繁的消息延迟问题，多是由于开发者自身 Webhook 请求网址不可用导致的，请开发者检查 Webhook 配置的请求网址 URL 的可用性。
    重试机制目前仍在调优中，调用后相关重试规则会在 Webhook 文档上公布。
    ​

    调用 xx 接口返回 html 格式数据

    调用相关接口，返回如下格式的 html 数据：
    <!doctype html>
<html lang="zh-cn">

<head>
    <meta charset="utf-8" />
    <title>抖音开放平台</title>
    <link rel="shortcut icon" href="//s3.bytecdn.cn/aweme/resource/web/static/image/logo/favicon_v2_7145ff0.ico"
        type="image/x-icon" />
    <link rel="dns-prefetch" href="//s3.bytecdn.cn/" />
    <link rel="dns-prefetch" href="//s3a.bytecdn.cn/" />
    <meta name="screen-orientation" content="portrait" />
    <meta name="x5-orientation" content="portrait" />
    <meta name="format-detection" content="telephone=no" />
    ...
    出现如上返回，表明未命中相关接口路由，请开发者参照接口文档详细检查自己的请求格式，包括但不限于：
      •是否与接口文档 path 完全一致，请求 path 末尾是否添加了 /
      •请求方法是否为接口文档要求的 POST / GET / ...
      •...
    ​

    用户进入私信会话页事件偶现缺失广告信息

    开发者在飞鱼后台能够看到广告信息，但是进私事件缺失广告信息，开发者需要自行联系商业化对接的运营同学进行排查。