{"code":0,"msg":"succeeded","data":{"directoryId":"7182025466500890652","name":"自建应用获取 app_access_token","type":"GuideDocumentType","title":"","allVisible":true,"redirectUri":"/server-docs/authentication-management/access-token/app_access_token_internal","bizScope":"7094820452015112220","id":"6995779366223822852","fullPath":"/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/app_access_token_internal","content":"# 自建应用获取 app_access_token\n\n自建应用通过此接口获取`app_access_token`。{尝试一下}(url=/api/tools/api_explore/api_explore_config?project=auth&version=v3&resource=app_access_token&method=internal)\n\n\n\n:::note\n**说明：** `app_access_token` 的最大有效期是 2 小时。\n\n- 如果在有效期小于 30 分钟的情况下，调用本接口，会返回一个新的 `app_access_token`，这会同时存在两个有效的 `app_access_token`。\n- 如果在有效期大于等于 30 分钟的情况下，调用本接口，会返回原有的 `app_access_token`。\n:::\n\n\n\n## 请求\n:::html\n<md-table>\n  <md-thead>\n  <tr>\n      <md-th>基本</md-th>\n      <md-th></md-th>\n  </tr>\n  </md-thead>\n  <md-tbody>\n    <md-tr>\n      <md-th>HTTP URL</md-th>\n      <md-td>https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal</md-td>\n    </md-tr>\n    <md-tr>\n      <md-th>HTTP Method</md-th>\n      <md-td>POST</md-td>\n    </md-tr>\n    <md-tr>\n      <md-th>支持的应用类型</md-th>\n      <md-td>\n      <md-app-support types=\"custom\"></md-app-support>\n      </md-td>\n    </md-tr>\n    <md-tr>\n      <md-th>\n            权限要求\n            <md-tooltip type=\"info\">调用该 API 所需的权限。开启其中任意一项权限即可调用</md-tooltip>\n            \n      </md-th>\n      <md-td>\n            无\n      </md-td>\n    </md-tr>\n  </md-tbody>\n</md-table>\n:::\n### 请求头\n:::html\n<md-table>\n  <md-thead>\n    <md-tr>\n      <md-th style=\"width: 18%;\">名称</md-th>\n      <md-th style=\"width: 15%;\">类型</md-th>\n       <md-th style=\"width: 15%;\">必填</md-th>\n      <md-th>描述</md-th>\n    </md-tr>\n  </md-thead>\n  <md-tbody>\n<md-tr>\n<md-td>Content-Type</md-td>\n<md-td>string</md-td>\n<md-td>是</md-td>\n<md-td>**固定值**：\"application/json; charset=utf-8\"</md-td>\n</md-tr>\n</md-tbody>\n</md-table>\n:::\n\n\n\n### 请求体\n\n:::html\n<md-table>\n  <md-thead>\n      <md-tr>\n      <md-th style=\"width: 40%;\">名称</md-th>\n      <md-th style=\"width: 20%;\">类型</md-th>\n      <md-th style=\"width: 10%;\">必填</md-th>\n      <md-th style=\"width: 30%;\">描述</md-th>\n      </md-tr>\n  </md-thead>\n  <md-tbody>\n\n<md-tr>\n\t<md-td>\n\t<md-text type=\"field-name\" >app_id</md-text>\n\t</md-td>\n\t<md-td>\n\t<md-text type=\"field-type\" >string</md-text>\n\t</md-td>\n\t<md-td>\n\t是\n\t</md-td>\n\t<md-td>\n应用唯一标识，创建应用后获得。有关`app_id` 的详细介绍。请参考[通用参数](/ssl:ttdoc/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/terminology)介绍\n      \n**示例值：** \"cli_slkdjalasdkjasd\"\n\t</md-td>\n</md-tr>\n\n\n<md-tr>\n\t<md-td>\n\t<md-text type=\"field-name\" >app_secret</md-text>\n\t</md-td>\n\t<md-td>\n\t<md-text type=\"field-type\" >string</md-text>\n\t</md-td>\n\t<md-td>\n\t是\n\t</md-td>\n\t<md-td>\n应用秘钥，创建应用后获得。有关 `app_secret` 的详细介绍，请参考[通用参数](/ssl:ttdoc/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/terminology)介绍\n      \n**示例值：** \"dskLLdkasdjlasdKK\"\n\t</md-td>\n</md-tr>\n\n  </md-tbody>\n</md-table>\n:::\n\n\n\n### 请求体示例\n\n```json\n{\n    \"app_id\": \"cli_slkdjalasdkjasd\",\n    \"app_secret\": \"dskLLdkasdjlasdKK\"\n}\n```\n\n\n\n## 响应\n\n\n\n### 响应体\n:::html\n<md-table>\n  <md-thead>\n      <md-tr>\n      <md-th style=\"width: 40%;\">名称</md-th>\n      <md-th style=\"width: 20%;\">类型</md-th>\n      <md-th style=\"width: 30%;\">描述</md-th>\n      </md-tr>\n  </md-thead>\n  <md-tbody>\n\n<md-tr>\n\t<md-td>\n\t<md-text type=\"field-name\" >code</md-text>\n\t</md-td>\n\t<md-td>\n\t<md-text type=\"field-type\" >int</md-text>\n\t</md-td>\n\t<md-td>\n错误码，非 0 取值表示失败\n\t</md-td>\n</md-tr>\n\n\n<md-tr>\n\t<md-td>\n\t<md-text type=\"field-name\" >msg</md-text>\n\t</md-td>\n\t<md-td>\n\t<md-text type=\"field-type\" >string</md-text>\n\t</md-td>\n\t<md-td>\n错误描述\n\t</md-td>\n</md-tr>\n\n\n<md-tr>\n\t<md-td>\n\t<md-text type=\"field-name\" >app_access_token</md-text>\n\t</md-td>\n\t<md-td>\n\t<md-text type=\"field-type\" >string</md-text>\n\t</md-td>\n\t<md-td>\n\t应用访问凭证\n\t</md-td>\n</md-tr>\n\n\n<md-tr>\n\t<md-td>\n\t<md-text type=\"field-name\" >expire</md-text>\n\t</md-td>\n\t<md-td>\n\t<md-text type=\"field-type\" >int</md-text>\n\t</md-td>\n\t<md-td>\n`app_access_token` 的过期时间，单位为秒 \n\t</md-td>\n</md-tr>\n    \n<md-tr>\n\t<md-td>\n\t<md-text type=\"field-name\" >tenant_access_token</md-text>\n\t</md-td>\n\t<md-td>\n\t<md-text type=\"field-type\" >string</md-text>\n\t</md-td>\n\t<md-td>\n租户访问凭证。了解不同的访问凭证，参见[访问凭证介绍](/ssl:ttdoc/ukTMukTMukTM/uMTNz4yM1MjLzUzM)。\n\t</md-td>\n</md-tr>\n\n  </md-tbody>\n</md-table>\n:::\n\n\n\n### 响应体示例\n\n```json\n{\n    \"app_access_token\": \"t-g1044ghJRUIJJ5ZPPZMOHKWZISL33E4QSS3abcef\",\n    \"code\": 0,\n    \"expire\": 7200,\n    \"msg\": \"ok\",\n    \"tenant_access_token\": \"t-g1044ghJRUIJJ5ZPPZMOHKWZISL33E4QSS3abcef\"\n}\n```\n\n### 错误码\n有关错误码的详细介绍，请参考[通用错误码](/ssl:ttdoc/ukTMukTMukTM/ugjM14COyUjL4ITN)介绍。\n\n","visibleTag":"All","updateTime":1719396900000,"templateName":""}}