抖音开放平台Logo
开发者文档
控制台

抖音获取授权码

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