获取访问凭证
访问凭证是接入飞书开放平台的钥匙，将应用获得的所有数据访问和接口调用权限绑定在一起，允许应用对资源进行读写操作。建议开发者在正式开发前对飞书的访问凭证机制有充分的了解。
访问凭证介绍
| 访问凭证类型 | 是否需要用户授权 | 说明 |
|---|---|---|
| tenant_access_token | 否 | 以应用身份调用 API 时需要使用的凭证，可读写的数据范围由应用的数据权限范围决定。该类凭证的值是jwt形式的字符串，示例值：eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJud0ItMWQ2NXgydFJUam5UMnZwdkpCczZXM1BWZEE2bGd6VDhDeGhnQ0xxxxxxxxxxxxxxxxxxxxxxxxzYsImlhdCI6MTcyNzIzMjM3NiwianRpIjoiNDA2YjBlMTgtMxxxxxxxxxxxxxxxxxxxxxxxxUwOTQzIiwiaXNzIjoiaHR0cHM6Ly90ZXN0LWtleWxxxxxxxxxxxxxxxxxxxxxxxxb250cmFjdCIsImF1ZCI6ImFjY291bnQiLCJzdWIiOiI2ZTVjNzBiMS0yYmZjLTQ0YjItYmRjYi0xMDBmYzBlYmRmMDMiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiJjbGlfYTYzN2RjZGEwMWZjb3BlbiIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiLyoxxxxxxxxxxxxxxxxxxxxxxxxRlZmF1bHQtcm9sZXMtY29udHJhY3QiLCJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJwcm9maWxlIGVtYWlsIiwiY2xpZW50SG9zdCI6IjE5Mi4xNjguMi42MyIsImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwicHJlZmVycmVkX3VzZXJuYW1lIjoic2VydmljZS1hY2NvdW50LWNsaV9hNjM3ZGNkYTAxZmNvcGVuIiwiY2xpZW50QWRkcmVzcyI6IjE5Mi4xNjguMi42MyIsImNsaWVudF9pZCI6ImNsaV9hNjM3ZGNkYTAxZmNvcGVuIn0.xxxxxxxxxxxxxxxxxxxxxxxx-K-7tgs_8k4SHLjpC_EVMWWGbRqlfrBTEZd9i2yE30unfcHqf7fipqkPRRiAVW8R1AzBx4rCyN5I2lq6HP3Hi9FwbMxSGFsdH4DLpNTE4iewuBtPHXs702CuVsps44xqvngOOYWvkYOsSGVzcjcdXmbWwlhiGYgAEO9Lp3kKVdn1YKIpF9XbjPNqW1c-tVLSK1LWUYFEfP5f9wlOESvacZfD2Jg77lHOMCSA8vU0rLKI5kN3tI79a4ZxFbxye7kU3rwcRluWDJBKMM-y_S_6zQ3hUhgSvkxdP3InRlEnwLXXXXXXX |
获取方式
访问凭证存在2个小时的有效期（在调用获取访问凭证接口后，会返回有效期字段 expire ）。开发者需要在自己的服务端设置定时刷新凭证的业务逻辑，以防止过期。如果在当前凭证过期前重新获取凭证，则会获取到新的凭证。
获取自建应用的 tenant_access_token
1.
2.
3.
cURL 请求配置示例如下：
调用API的详细操作参见 调用API。
修改于 2025-11-11 09:48:43