OpenAPI 导入
功能概述
管理平台支持通过导入文件的形式创建项目或对一个已有项目做增量更新。从3.0_04001版本开始,除支持原生文件外,还可以支持符合swagger3.0标准定义的文件(json/yaml)。
使用说明
通过导入文件创建项目
从swagger文件导入创建新项目时需要填写新的项目名称和项目路径。导入完成后,系统会跳转到项目管理列表页面。
在已有项目基础上追加导入
在已有项目上也可以支持通过swagger进行增量导入的操作。点击导入,选择swagger文件,因为swagger文件中没有平台的项目版本信息,所以文件导入成功之后,可以直接点击完成。系统会跳转到项目/开发页面,并停留在工作区等待用户进行下一步操作。
注意:如果您的文件采用的是早期的 swagger2.0 标准,可以通过以下工具进行文件版本的转换,之后再进行导入。推荐两款格式转换工具
从V3.0_05000版本开始在进行项目导入的时候会对D2A数据进行检测。如果导入的目标项目中没有文件中的D2A数据则可以直接导入。如果导入的目标项目中包含了当前文件中的D2A数据,那么会给用户提供三种选择。覆盖导入、放弃导入、或 仅导入非D2A的项目数据。 用户可以根据实际需要选择导入模式。