抖音开放平台Logo
开发者文档
控制台
  • OpenAPI 列表
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 抖音获取授权码
  • 获取 access_token
  • 刷新 refresh_token
  • 生成 client_token
  • 刷新 access_token
  • 获取用户公开信息
  • 获取用户手机号
  • 用户经营身份管理
  • 获取用户唯一标识
  • 获取client_code
  • 获取access_code
  • 关系能力
  • 内容能力
  • 互动评论
  • 私信群聊
  • 企业号开放能力(内测结束暂不开放)
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权
  • 抖音获取授权码

    收藏
    我的收藏
    授权整体流程详见授权概述
    该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