---
title: Portal 与订阅
description: 组织成员如何管理接入应用、查看订阅、密钥和用量。
---

# Portal 与订阅

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 天调用量。

平台负责创建订阅集并给应用分配、续期、暂停或取消订阅。组织成员不能自行扩大数据集、平台、字段或配额。

## 权限计算

应用最终可访问范围为：

```text
组织访问上限 ∩ 数据订阅集范围 ∩ 应用订阅获批范围
```

一个应用可以有多条有效订阅，调用时合并各订阅允许的范围。订阅过期、取消或停用后，对应权限立即失效，但其他有效订阅和 API Key 不受影响。

## 角色

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

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