API Keys
集中管理应用的访问凭证
API Key 列表
功能说明
「API Keys」页集中管理应用的访问凭证，用于调用接口的身份鉴权。页面顶部展示接口调用的 Base URL（如 https://router.fis.aliyuncs.com/finx，支持一键复制）；列表表头为：API Key / 描述 / 创建时间 / 操作，其中「操作」列提供红色「删除」链接。右上角提供「了解更多」文档入口。
前置条件
- 已进入目标应用空间。
操作步骤
- 点击侧边栏「API Keys」进入页面。
- 复制顶部 Base URL，用于客户端接口调用的服务地址配置。
- 在「搜索描述 / 前缀…」输入框中检索已有 API Key（支持按描述、密钥前缀或 ID 检索；列表中密钥仅显示前缀，如
dk_sz9m0...）。
预期结果：列表展示当前空间的 API Key 概要信息，明文密钥不在列表中展示。没有密钥时显示「暂无 API Key」，并提示「点击「创建 API Key」生成首个访问凭证」；检索不到时显示「未找到匹配的 API Key」。
图 2-17：API Keys 页——顶部为 Base URL，列表仅展示密钥前缀、描述与创建时间，行尾提供「删除」操作。
创建 API Key（分步图解）
功能说明
创建流程由「填写信息 → 生成并保存明文」两步弹窗组成。创建弹窗描述原文：「该 API Key 将归属于以下应用空间，可访问该空间下的所有资源，请妥善保管。」
前置条件
- 已进入目标应用空间的「API Keys」页。
操作步骤
点击列表右上角「创建 API Key」，打开「创建 API Key」弹窗。弹窗中「应用空间」固定显示当前空间（不可更改）。「描述」为选填，用于说明用途（如「主应用的生产环境 API Key」），最长 50 个字符，输入框右侧实时显示字数（如「12/50」）。
图 2-18：创建 API Key 弹窗——确认归属应用空间并填写描述，点击「生成 API Key」。
点击「生成 API Key」。系统提示「API Key 创建成功」，并弹出结果窗口（说明「请复制并保存 API Key。」），顶部为醒目警示：「请妥善保存 API Key —— API Key 明文仅在创建时展示一次，关闭此窗口后将无法再次查看完整密钥。」
在结果窗口中点击眼睛图标查看明文，点击复制图标将完整密钥复制到安全的密钥管理工具中妥善保存。
图 2-19：API Key 创建结果——明文仅此一次展示，务必先复制保存，再点击「我已保存，关闭」。
确认已妥善保存后，点击「我已保存，关闭」关闭窗口。
预期结果：系统提示「API Key 创建成功」；列表中出现新密钥的前缀记录。
API Key 明文仅在创建时展示一次，关闭结果窗口后将无法再次查看完整密钥。若未保存即关闭，只能删除该密钥并重新创建。
删除 API Key
功能说明
删除操作用于吊销不再使用的 API Key。
前置条件
- 确认目标密钥已无线上调用依赖。
操作步骤
- 在列表中找到目标 API Key，点击行尾红色「删除」。
- 系统弹出「确认删除 API Key」对话框，文案为：「即将删除 API Key dk_ctJhk...，删除后使用该密钥的调用将立即失效，此操作不可撤销。」
- 确认无误后点击「确认删除」；如需放弃，点击「取消」。
预期结果：系统提示「API Key 已删除」，列表中该密钥消失。
图 2-20：删除 API Key 二次确认对话框——删除后使用该密钥的调用将立即失效。
删除 API Key 不可撤销，删除后使用该密钥的调用将立即失效。请务必先完成调用方的密钥轮转，再执行删除。
注意事项 / 异常处理
- API Key 归属于单个应用空间，仅能访问该空间下的资源；跨空间调用请在对应空间分别创建密钥。
- 密钥疑似泄露时，应立即创建新密钥完成替换，随后删除旧密钥。