CodeArts API在API设计界面提供代码编辑模式进行API设计,可使用yaml格式设计接口文档。在编辑模式中CodeArts API提供API规范性检查。
通过规范性检查功能,可以形成统一的设计规范,避免API设计不一致,提高API设计质量。API规范设计定义,请参照设置API设计规范。
- 编辑模式
- 规范性检查
设置API设计规范
单击项目名称,进入目标项目,单击“项目设置 > 设计规范设置”,进入“设计规范设置”页面。
- 新增设计规范
- 在“设计规范”页签,单击“新增设计规范”,填写规范名称,选择是否继承已创建的规范、填写规范描述。
- 单击“确定”,进入“设计规范”页面,打开规则后的“是否启用”按钮,可启用当前规则。
- 完成创建API设计规范后,单击“启用”,可正式使用设计规范。
- 无需检查接口
支持添加无需检查接口。
- 在“无需检查的接口”页签,单击“添加API接口”,弹出“添加不需要检查的接口”对话框。
- 选择无需检查接口,单击“确定”,完成添加。
- 快捷搜索
可输入关键字快捷查找已存在的设计规范。
- 设计规范定义更新
单击“管理”,可以修改设计规范中启用的设计规则。
单击“编辑”,可以修改设计规范的名称和描述。
- 设计规范删除
单击“删除”,可以删除设计规范。