获取登录预授权码

GET

https://open.feishu.cn/open-apis/authen/v1/index

调用本接口获取用户的登录预授权码 code。登录预授权码的有效期是 5 分钟，且只能被使用一次。

说明：本接口适用于用户登录网页应用场景。当用户在飞书内打开网页应用时，会跳转到飞书登录界面，用户授权后，会自动跳转到重定向 URL，并携带飞书开放平台返回的登录预授权码 code。有关重定向 URL 的详细介绍，请参考获取 user_access_token。

请求示例：GET https://open.feishu.cn/open-apis/authen/v1/index?app_id=cli_9dff7f6ae02ad104&redirect_uri=https%3a%2f%2fopen.feishu.cn%2fdocument%2fuQjL04CN%2fucDOz4yN4MjL3gzM&state=RANDOMSTATE

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/authen/v1/index' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "redirect_uri\t": "string",
    "app_id": "string",
    "state": "string"
}'

响应示例

https://open.feishu.cn/document/uQjL04CN%2fucDOz4yN4MjL3gzM?code={AuthorizationCode}&state=RANDOMSTATE

请求参数

Query 参数

redirect_uri

string

可选

示例值:

{REDIRECT_URI}

app_id

string

可选

示例值:

{APPID}

state

string

可选

示例值:

{STATE}

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

redirect_uri

string

必需

重定向 URL，需要经过 Encode 处理 1. 重定向 URL 使用于网页应用。可以在开发者后台，应用功能 > 网页页面启用网页功能，并配置桌面端主页和移动端主页 2. 调用本接口前，需要在开发者后台的安全设置页面，配置重定向 URL，支持配置多个。只有在重定向 URL 列表中的 URL 才会通过开放平台的安全校验

app_id

string

必需

应用 ID，可以在开发者后台的凭证与基础信息页面查看 app_id。有关 app_id 的详细介绍，请参考通用参数

state

string

可选

用来维护请求和回调状态的附加字符串，在授权完成回调时会附加此参数，应用可以根据此字符串来判断上下文关系

示例