获取访问凭证

功能简介

访问凭证（也称为 access_token）代表应用从平台、租户（指公司或者团队）、用户手中获得的授权。调用服务端 API 之前，需要从飞书开放平台获取相应的访问凭证。有关访问凭证的详细介绍，请参考通用参数中的介绍。

注意： 为了安全考虑，请勿在应用前端使用访问凭证，请在应用服务端发起 API 访问请求。

操作方式

Step 1：确认 API 支持的访问凭证

访问凭证要填充到 HTTP 请求头中。在 API 文档的请求头部分，描述了该 API 支持的访问凭证类型。

Step 2：选择合适的访问凭证

同一个 API 可能支持多种访问凭证。选择访问凭证时，请注意如下几点：

不同的访问凭证代表了不同的资源访问权限。

API 可能会支持一种或多种访问凭证。

调用同一个 API，使用不同的访问凭证将会获取不同的数据。

请根据应用场景，选择合适的访问凭证：

访问凭证类型	是否需要用户登录/授权	说明
`app_access_token`	N	应用使用自己的身份进行相关的操作，访问的数据范围、可以执行的操作将会受到应用自身的数据权限的影响
`tenant_access_token`	N	由于商店应用会为多家企业提供服务，所以需要先获取对应企业的授权访问凭证 `tenant_access_token`，并使用该访问凭证来调用 API 访问企业的数据或者资源
`user_access_token`	Y	应用以用户的身份进行相关的操作，访问的数据范围、可以执行的操作将会受到该用户的权限影响

Step 3：获取访问凭证

自建应用获取 tenant_access_token

登录开发者后台。

在企业自建应用列表中，点击指定应用，进入应用详情页。

进入 凭证与基础信息 页面，在 应用凭证 处，获取 AppID 和 App Secret。

调用自建应用获取 tenant_access_token接口，获取自建应用的 tenant_access_token。

自建应用获取 app_access_token

获取 AppID 和 App Secret。

请参考下方的商店应用获取 AppID 和 App Secret 的方式进行操作。

调用自建应用获取 app_access_token接口，获取自建应用的 app_access_token。

商店应用获取 app_access_token

获取 app_ticket

为了提高数据访问的安全性，对商店应用增加了 app_ticket 作为安全凭证。

配置事件订阅的请求地址后，飞书会每隔 1 小时向该地址自动推送最新的 app_ticket，应用根据接收到的app_ticket 事件来获取app_ticket，接收到app_ticket后，请保存，以便后续使用。

（可选）调用重新获取 app_ticket接口，触发飞书重新推送 app_ticket。

app_ticket 推送可能存在延迟，如果没有收到推送，可以触发重新推送 app_ticket。

获取 AppID 和 App Secret

登录开发者后台。

在商店应用列表中，点击指定应用，进入应用详情页。

进入 凭证与基础信息 页面，在 应用凭证 处，获取 AppID 和 App Secret。

获取 app_access_token

利用获取的 App ID、App Secret 和 app_ticket，调用商店应用获取 app_access_token接口，获取 app_access_token。

商店应用获取 tenant_access_token

说明： 请在获取商店应用的 app_access_token 后，再获取商店应用的 tenant_access_token。

获取 tenant_key。

tenant_key为租户在飞书上的唯一标识，用来换取对应的 tenant_access_token，也可以用作租户在应用里面的唯一标识，可以通过如下方式获取：

业开通应用时，开放平台推送给应用，具体可参考首次启用应用。

用户登录到小程序、H5 应用或者浏览器应用时，在用户的身份信息中获取。

获取 tenant_access_token。

根据 app_access_token 和 tenant_key，调用商店应用获取 tenant_access_token接口，获取 tenant_access_token。

获取 user_access_token

如下方式用于网页应用免登录应用场景，小程序应用获取 user_access_token 的方法，请参考小程序应用提供的code2session接口。

说明： 本方式适用于自建应用和商店应用。

配置重定向 URL。

飞书开放平台会校验应用发送过来的重定向 URL 的合法性，仅在重定向 URL 列表中的 URL 会通过校验。

登录开发者后台，进入应用详情页。进入 安全设置 > 重定向 URL 页面。添加重定向 URL。

调用获取登录预授权码接口，获取登录预授权码 code。

调用该接口时，需要携带 App ID 参数，可以在 凭证与基础信息 页面获取 App ID。

调用获取 user_access_token接口，获取 user_access_token。

（可选）调用刷新 user_access_token接口，刷新 user_access_token。

user_access_token 的有效期是 6900 秒，过期后，需要刷新后再使用。

功能简介#

操作方式#

Step 1：确认 API 支持的访问凭证#

Step 2：选择合适的访问凭证#

Step 3：获取访问凭证#

自建应用获取 tenant_access_token#

自建应用获取 app_access_token#

商店应用获取 app_access_token#

获取 app_ticket#

获取 AppID 和 App Secret#

获取 app_access_token#

商店应用获取 tenant_access_token#

获取 user_access_token#