Skip to content

商店应用获取 app_access_token

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

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

请求

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

请求头

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

请求体

名称类型必填描述
app_idstring应用唯一标识,创建应用后获得。有关app_id 的详细介绍。请参考通用参数介绍 示例值: "cli_slkdjalasdkjasd"
app_secretstring应用秘钥,创建应用后获得。有关 app_secret 的详细介绍,请参考通用参数介绍 示例值: "dskLLdkasdjlasdKK"
app_ticketstring平台定时推送给商店应用的临时凭证。该凭证的获取方式如下: 1. 创建商店应用后,需要为应用配置事件订阅,订阅 app_ticket 事件。 订阅后,飞书开放平台会以 1 次/小时的频率向接收事件的服务端自动推送 app_ticket。 2. (可选)调用重新获取 app_ticket接口,主动触发 app_ticket 事件示例值: "dskLLdkasd"

请求体示例

json
{
    "app_id": "cli_slkdjalasdkjasd",
    "app_secret": "dskLLdkasdjlasdKK",
    "app_ticket": "dskLLdkasd"
}

响应

响应体

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

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "app_access_token": "a-6U1SbDiM6XIH2DcTCPyeub",
    "expire": 7140
}

错误码

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

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