Skip to content

商店应用获取 tenant_access_token

商店应用通过此接口获取tenant_access_token

Note说明 tenant_access_token 的最大有效期是 2 小时。如果在有效期小于 30 分钟的情况下,调用本接口,会返回一个新的 tenant_access_token,这会同时存在两个有效的 tenant_access_token

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/auth/v3/tenant_access_token
HTTP MethodPOST
支持的应用类型isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用

请求头

名称类型必填描述
Content-Typestring固定值:"application/json; charset=utf-8"

请求体

名称类型必填描述
app_access_tokenstring应用访问凭证,通过商店应用获取 app_access_token接口获取 示例值: "a-32bd8551db2f081cbfd26293f27516390b9feb04"
tenant_keystring租户在飞书上的唯一标识,也可以理解为企业标识 可以通过如下方式获取: - 企业开通应用时,开放平台推送给应用,具体可参考首次启用应用 - 用户登录到小程序、H5 应用或者浏览器应用时,在用户的身份信息中获取 示例值:"73658811060f175d"

请求体示例

json
{
    "app_access_token": "a-32bd8551db2f081cbfd26293f27516390b9feb04",
    "tenant_key": "73658811060f175d"
}

响应

响应体

名称类型描述
codeint错误码,非 0 取值表示失败
msgstring错误描述
tenant_access_tokenstring租户访问凭证
expireinttenant_access_token 的过期时间,单位为秒

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "tenant_access_token": "t-caecc734c2e3328a62489fe0648c4b98779515d3",
    "expire": 7140
}

错误码

有关错误码的详细介绍,请参考通用错误码介绍。

内容来源:飞书开放平台 · 自动爬取整理