Developer Portal Menu Management
概述
本教程指导您管理开发者门户的导航菜单结构。您可以为顶部导航栏配置多级菜单,将每个项目链接到内容或 URL,并为终端菜单节点编写详细的基于 HTML 的页面。该结构支持最多 3 层深度。
先决条件
要访问菜单管理:
- 您必须具有管理员访问权限
- 转到:管理 > 菜单管理
分步教程
第 1 步. 理解菜单层次结构
菜单由多个层级组成:
- 第 1 层:顶部导航(例如,产品、应用程序、文档、论坛)
- 第 2 层:子菜单组(例如,所有 API、渗透测试)
- 第 3 层:终端节点(例如,版本 1、指南),可以在此添加内容
只有第 3 层菜单可以具有可编辑的内容页面。
第 2 步. 添加或编辑菜单项
A. 添加新菜单项:
- 点击所需父菜单旁边的 + 图标
- 输入菜单标题(例如,用户指南)
- 选择可见性(可见 / 隐藏)
- 点击注册
B. 编辑现有项:
- 点击菜单旁边的铅笔图标
- 根据需要更改名称或重新排序
- 点击保存以应用更改
第 3 步. 编写或编辑菜单内容(仅限第 3 层)
要编辑终端节点的内容:
- 选择一个菜单,例如文档 > 版本 1
- 在右侧窗格中输入:
| Field | Example |
| --- | --- |
| 标题 | 版本 1
| | 可见 | 已选中 | | 内容 | 富文本(HTML 编辑器) |
富内容示例:
# API 入门流程
## 1. 注册应用程序
在 **应用程序 > 我的应用程序** 部分注册您的应用程序。
## 2. 设置 IP 引用并请求访问
配置 IP 引用并通过 **Application > My Applications > API Usage** 提交您的 API 使用请求。
## 3. 测试和使用 API
一旦获得批准,在 **Test** 标签中测试您的 API 或开始实际使用。
## 4. 管理团队成员
在 **Application > My Applications > Members** 中将队友添加到您的注册应用程序。
添加图片或文件:
- 使用添加图片或添加文件按钮
- 上传的文件将出现在编辑器下方,并可以附加到内容中
编辑器支持标题、格式、链接、表格和内联 HTML。
第 4 步. 保存菜单内容
- 编辑完成后,点击内容窗格底部的保存按钮
- 确认在访问开发者门户时内容正确呈现
最佳实践
- 使用清晰的层次结构来组织 API 和指南
- 按域或产品线对 API 参考进行分组(例如,/AI、/Security、/OpenAPI)
- 保持菜单标题简洁(不超过 25 个字符以提高可读性)
- 使用 HTML 编辑器通过标题、链接和样式增强可读性
- 定期检查是否有损坏的链接或过时的内容