个人授权 - 连续第三方应用

---

什么是第三方应用

第三方应用是 HAP 提供的一套标准 OAuth 2.0 授权机制，允许第三方应用在用户授权后，以用户身份安全访问或操作用户在 HAP 中的数据。使用短生命周期的访问凭证（Access Token），相比长期密钥方式更加安全和可控。

通过第三方应用可以：

• 以用户身份访问在 HAP 中的资源

• 以用户执行操作（如创建记录、修改记录）

• 通过接口权限（Scope）限制可访问能力

组织管理员管控

管理入口

管理员通过 【组织管理】 > 【集成】 > 【第三方应用】 进入管理后台。

此处汇总了所有已连接至 HAP 平台的外部官方集成应用。为了实现跨平台协作，HAP 将陆续上架到 GPT、CodeX、Claude Code等平台应用市场。

管理操作

• A. 配置数据访问范围

  接口权限： 查看该应用申请调用的具体 API 能力（如只读、可写等）。

  应用范围： 指定该集成可被用于组织内的哪些具体应用或工作表。

  

2. 启用与关闭状态管理

   管理员可以随时一键切断第三方应用的访问权限。当应用 关闭 时，系统将执行以下安全逻辑：

   • 立即阻断：所有已发放的 $Access Token$（访问令牌）立即失效，API 请求将返回未授权错误。
   • 授权作废：所有已授权用户的连接状态将变为“已失效”，且无法通过 $Refresh Token$ 换取新令牌。
   • 停止准入：新用户尝试发起授权时，系统将拦截并报错。
   • 用户侧变更：用户个人账户中仅保留历史授权记录，无法再进行任何数据交互。

   点击右上角【关闭集成】，将关闭所有应用的集成状态。

用户授权流程

发起授权： 在第三方应用中点击“登录 HAP”。

确认权限： 在弹出的授权页面中，核对应用请求的权限范围（Scope）。

完成对接： 确认授权后，该应用即可在权限范围内代表您进行操作。

管理授权： 个人用户可在【个人中心】>【账号设置】>【授权管理】中随时主动终止授权。

以集成中心上架的 【HAP API（个人授权）】 为例，标准授权流程如下：

1. 安装 API 模板

   

2. 添加账户

   

3. 授权

   

4. 终止授权