在 Apidog 中,一个有用的内置字段是 端点状态。该字段用于指示端点的状态,例如正在开发、测试中或已发布。端点状态字段既会显示在 Apidog 应用中,供内部团队参考,也会显示在由 Apidog 生成、面向外部用户的 API 文档中。使用端点状态#
在 Apidog 中指定端点时,你可以选择端点的状态。默认情况下,新创建的端点会被设置为 开发中。在端点规范中,每个状态名称前都会带有一个彩色圆点,用于表示端点的不同状态。这个颜色编码系统可以帮助用户在端点目录树中快速区分端点及其对应状态。配色方案#
| 颜色 | 状态 | 描述 |
|---|
| 蓝色 | 开发中 | 端点当前正在开发中 |
| 红色 | 测试中 | 端点正在测试中 |
| 灰色 | 已弃用 | 端点已弃用 |
| 无圆点 | 已发布 | 端点已发布,不需要特别关注 |
在已发布的文档中,你也会看到这些彩色圆点用于标记端点状态。配置端点状态#
每个团队的开发流程可能不同,所需的端点状态也会相应有所差异。Apidog 允许团队根据具体需求自定义并选择要使用的端点状态。你可以在 设置 > 通用设置 > 功能设置 > 端点功能设置 中配置并启用所需的端点状态。FAQ#
答:由于不同状态对应特定功能,因此不支持自定义新状态。你可以从列出的状态中选择最适合团队需求的状态。 Modified at 2026-06-09 08:55:47