按需查阅，不是必读接入步骤。接入路线：[查询取数接入路线](/docs)

# 应用与订阅管理

Portal 面向组织成员。数据 API 面向接入应用，两者使用不同凭证。


```mermaid
flowchart LR
  platform[Whale 平台] --> product[数据订阅集]
  product --> subscription[应用订阅]
  organization[组织] --> application[接入应用]
  application --> subscription
  subscription --> scope[数据集 / 平台 / 字段 / 配额]
  application --> key[应用密钥]
  key --> api[数据 API]
```


## 操作路径

访问 [客户 Portal](/portal) 并使用组织成员账号登录：

1. 在“接入应用”中选择应用。
2. 在“订阅与权限”查看平台分配的订阅和获批范围。
3. 在“应用密钥”生成或查看密钥状态。
4. 在“用量”查看最近 30 天调用量。

平台负责配置应用访问策略。尚未配置过策略的应用继承 Admin「平台默认访问策略」；该策略初始全开，但平台管理员可配置数据集、平台、字段、功能和配额，或关闭默认访问。平台保存组织或应用显式策略后，可进一步缩小范围，也可停用全部访问。组织成员不能自行扩大平台设定的范围或配额。

应用访问策略决定应用能读取什么；[用户与频道采集](/docs/collection-subscriptions)用于安排周期采集，也受同一策略控制。

## 权限计算

应用从未配置过策略时，使用 Admin 配置的平台默认访问策略。存在显式策略时，最终可访问范围为：


```text
组织访问上限 ∩ 数据产品范围 ∩ 应用显式策略
```


一个应用可以有多条有效授权，调用时合并各授权允许的范围。只要应用存在任何显式策略记录，就不再使用平台默认策略；策略停用、订阅过期或取消后，对应权限立即失效。

## 角色

| 角色 | 查看应用 | 创建应用 | 生成密钥 | 查看订阅和用量 |
| --- | --- | --- | --- | --- |
| owner / admin | 是 | 是 | 是 | 是 |
| developer / viewer | 按授权应用 | 否 | 否 | 是 |

完整 API Key 只在创建成功时显示一次。Portal 后续只显示前缀和最近使用时间。

## 继续当前任务

[返回接入路线](/docs)；查完所需信息后，回到正在执行的步骤。