抖音开放平台Logo
开发者文档
控制台
  • OpenAPI 列表
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 用户授权
  • 抖音获取授权码
  • 获取 access_token
  • 刷新 refresh_token
  • 生成 client_token
  • 刷新 access_token
  • 用户管理
  • 视频管理
  • 互动管理
  • 搜索管理
  • 数据开放服务
  • 企业号开放能力(内测结束暂不开放)
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权
  • 抖音获取授权码

    收藏
    我的收藏
    授权整体流程详见授权概述。​
    该URL是浏览器直接访问的前端页面,而并非OpenAPI接口。只适用于抖音获取授权临时票据(code),访问该 URL会跳转到开放平台提供的授权扫码页,用户扫码即可授权。​
    打开该 URL 后,页面会出现一个二维码,用户扫描该二维码即可授权。在抖音 App 支持端内唤醒的版本内打开的话会弹出客户端原生授权页面。​

    接口说明​

    前提条件​

      需要去官网为应用申请 scope 的使用权限。​
      需要在本接口的 scope 传参中填上需要用户授权的 scope,多个 scope 以逗号分割。​
      用户授权通过后,应用有权限通过 access_token 调用相应接口。​

    注意事项​

      获取的 code 可以用来调用 https://open.douyin.com/oauth/access_token/ 换取用户 acccess_token。​
      code会回调给redirect_uri,具体流程参考授权概述。​

    基本信息​

    HTTP URL
    https://open.douyin.com/platform/oauth/connect/​
    HTTP Method
    GET

    请求参数​

    URL 请求​

    名称​
    类型​
    是否必填​
    描述​
    示例值​
    client_key​
    string​
    true​
    应用唯一标识​
    aw5uktj8ot******​
    response_type​
    string​
    true​
    写死为 code 即可​
    code​
    scope​
    string​
    true​
    应用授权作用域,多个授权作用域以英文逗号(,)分隔​
    user_info,friend_relation​
    optionalScope​
    string​
    false​
    应用授权可选作用域,多个授权作用域以英文逗号(,)分隔,每一个授权作用域后需要加上一个是否默认勾选的参数。​
      1:勾选​
      0:不勾选​
    optionalScope=friend_relation,1,message,0​
    redirect_uri​
    string​
    true​
    授权成功后的回调地址,必须以 https 开头,存在(#)等特殊符号时请对回调地址做 urlEncode 处理。​
    地址必须对应申请应用时填写的重定向 URL,仅校验(#)前的内容。如不清楚请联系应用申请人。 例:配置的重定向 uri 为 https://aa.bb.cc/dd/,授权时传的 redirect_uri 为 https://aa.bb.cc/dd/#xxxx 则授权时会截取 redirect_uri 中 # 号前的 https://aa.bb.cc/dd/ 进行校验,判断是否存在配置中。 ​
    注意
    redirect_uri 中不支持携带自定义 query 参数。​
    state​
    string​
    false​
    用于保持请求和回调的状态​
    douyin​