API 集成中心：功能分节

API 资产

功能说明：维护平台对外暴露的 API 元数据，是后续授权、路由、策略的关联主体。

操作步骤：

1. 点击 Tab 「API资产」。
2. 在搜索框输入编码、名称或备注，回车或点 刷新 查询。
3. 点击 新增，在弹窗中填写字段后保存。
4. 对已有记录可 编辑、复制（生成新记录，不含接口ID）、删除。
5. 对草稿/未发布接口：确认后点 发布；对已发布接口点 下线。

主要字段：

预期结果：保存后提示「已保存」；发布/下线后列表状态更新，概览指标刷新。

注意事项：发布、下线、删除均有二次确认弹窗；删除不可恢复。

API 注册

功能说明：与 API 资产共用同一数据表与字段集，用于 注册视角 维护接口（界面与 API 资产一致，可按组织流程区分使用）。

操作同 4.1（无单独的发布/下线按钮时，以资产 Tab 为准）。

API 分类

功能说明：为 API 建立分类树，便于检索与权限划分。

操作步骤：新增 → 填写父分类ID、编码、名称、所属应用 → 保存。

主要字段：分类ID（只读）、父分类ID、编码、名称、所属应用 appCode、备注。

API 参数

功能说明：为指定 apiId 维护请求/响应参数定义。

主要字段：参数ID、接口ID、编码、名称、类型、默认值、备注。

调用方

功能说明：登记调用 API 的系统或应用（内部、OpenAPI、合作伙伴）。

主要字段：

凭证

功能说明：为调用方配置 AK/SK、Token 等认证信息。

主要字段：调用方ID、认证方式（AKSK/TOKEN/DSP_TOKEN/INTERNAL）、AccessKey、Secret（仅保存时提交）、Token、过期时间、状态。

注意：Secret、Token 仅在保存时提交，列表不回显明文。

授权

功能说明：建立调用方与 API 的允许/拒绝关系及有效期。

主要字段：调用方ID、接口ID、授权类型（ALLOW/DENY）、开始/过期时间、状态。

策略

功能说明：按 API 或调用方配置限流、配额、熔断、降级。

策略类型 policyType：RATE_LIMIT、QUOTA、CIRCUIT、DEGRADE；配合时间窗口、调用次数、失败阈值、降级内容等字段。

白黑名单

功能说明：按 IP、用户、组织、应用等维度限制访问。

主要字段：名单类型（ALLOW/DENY）、目标类型（IP/USER/ORG/APP）、目标值。

路由

功能说明：将对外路径映射到上游服务，配置方法、优先级、超时。

主要字段：路由编码/名称、接口ID、路径、方法、上游ID、优先级、超时(ms)。

上游服务

功能说明：定义后端服务集群的基础地址与健康检查。

主要字段：上游编码/名称、服务编码、协议、基础地址 baseUrl、健康检查路径。

上游实例

功能说明：在上游服务下维护具体主机、端口、权重与健康状态。

调用日志

功能说明：查询历史调用记录，用于联调与故障排查。

主要列：Trace ID、接口编码、调用方ID、请求路径、状态码、耗时、是否命中限流/熔断。

监控分析

功能说明：按分钟聚合的调用量、成功率、耗时等指标。

审计记录

功能说明：记录配置变更类操作，满足合规审计。

对接文档

功能说明：查看已生成的 API 文档快照（Markdown / OpenAPI JSON），支持复制。

操作步骤：

1. 切换到 「对接文档」 Tab。
2. 搜索 API 编号、应用或接口ID，点击 刷新。
3. 在左侧表格 点击一行，右侧显示预览。
4. 在 Markdown / OpenAPI 子 Tab 间切换查看。
5. 点击 复制 Markdown 将文档复制到剪贴板（提示「已复制」）。