咱们能够通过创立 API 文档模板,并应用 API 文档模板来增加 API 文档,用于实现进步 API 文档创立效率,标准 API 文档格局的目标。
该性能是付费版本性能,须要降级为企业版方可应用。
创立 API 文档模板
性能入口 :API 治理利用 / 选中某个我的项目 / 公共资源菜单 / API 文档模板二级菜单 / 点击“+ 增加 API 模板”
API 文档模板的可编辑内容和 API 文档编辑内容统一,操作体验同步,具体编辑操作可参考 《编辑 API 文档》。
- API 文档模板层级
- API 文档模板属于公共资源,所有公共资源均领有层级归属,分为利用模块级和我的项目级。利用模块级的公共资源可被所有我的项目应用,我的项目级的公共资源仅可被以后我的项目应用。
- 利用模块级的 API 文档模板,可在 API 治理利用界面的公共资源二级菜单“API 文档模板”菜单中创立和编辑。
应用模板
性能入口:API 治理利用 / API 文档菜单 / 点击“+ API”按钮旁的下拉按钮 / 选中“从模板增加 API”
抉择模板后,新建 API 文档中主动导入 API 模板内容。须要留神的是,模板与新建的 API 文档无关联关系。即后续模板内容变更不会影响该 API 文档的内容。