抖音开放平台Logo
控制台

抖音获取授权码

更新时间 2024-07-24 02:58:49
收藏
我的收藏
授权整体流程详见授权概述。​
该页面只适用于抖音获取授权临时票据(code)。​
请求该 URL,会跳转到开放平台提供的授权扫码页,用户扫码即可授权。​

接口说明​

前提条件​

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

注意事项​

    该URL是浏览器直接访问的前端页面,并非OpenAPI。​
    打开该 URL 后,页面会出现一个二维码,用户扫描该二维码即可授权。在抖音 App 支持端内唤醒的版本内打开的话会弹出客户端原生授权页面。​
    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​