前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Apifox如何一键导入Swagger数据?

Apifox如何一键导入Swagger数据?

原创
作者头像
Bob晴天
发布2022-07-01 17:38:13
9580
发布2022-07-01 17:38:13
举报
文章被收录于专栏:apifoxapifox

Hi,大家好。API 管理文档是必不可少的一项技能,在这方面 Swagger 做的非常出色。但是管理 API 文档只是其中的一部分,还有很多事情 Swagger 无法完成,或者无法高效完成,比如:API 文档定义、API Mock、API 自动化测试等等,Apifox就是为了解决这个问题而生,Apifox如何一键导入Swagger数据?今天给大伙介绍一下Apifox这位新晋高富帅。

导入 OpenAPI (Swagger) 数据

支持导入 OpenAPI 3、Swagger 1、2、3 数据格式的 json 或 yaml 文件。

#手动导入

打开 项目设置 面板,点击 手动导入 ,可选择文件导入或 URL 导入。

#手动导入-文件导入

可以将 json 或 yaml 文件拖拽到下图区域,也可以点击下图区域通过系统的文件管理器选择对应的 json 或 yaml 文件。

#手动导入-URL 导入

注意

需要 URL 导入的时候,需要填写的是 json 或 yaml 数据文件的 URL,而不是 Swagger UI 的 URL。

#导入-高级设置

导入 OpenAPI/Swagger 格式只包含 接口、数据模型、环境 。

  1. 接口覆盖模式
    1. 同 URL 覆盖:当两个文件 URL、method 相同时,新文件会覆盖旧文件。
    2. 同 URL 且同分组才覆盖:当两个文件的 URL、method 相同时,并且在同一个分组下时,新文件会覆盖旧文件。
    3. 同 URL 不导入:当两个文件 URL、method 相同时,新文件不会导入。
    4. 同 URL 时保留两者:当两个文件 URL、method 相同时,新文件会导入,旧文件不会被删除。
  2. 导入到分组:支持将文件导入到具体的分组中。
  3. 导入接口用例:开启开关后,已选择接口下的 接口用例 默认全选,也可以在 导入预览 中选择对应 接口用例 。
  4. tip:当导入非 Apifox 格式文件,且接口文档覆盖时,名称相同的 接口用例 不会导入,不同名称的 接口用例 会新增。
  5. 数据模型需要独立设置 选择覆盖模式 和 导入到分组 的,如图

#自动导入

打开 项目设置 面板,点击 自动导入 ,可设置 多个数据源 ,定时同步到 具体分组 中。

注意

只有角色为管理员,且打开客户端的时候,才会按照设置的导入频率 自动导入 。

其他角色不会触发自动导入 。

注意

需要 URL 导入的时候,需要填写的是 json 或 yaml 数据文件的 URL,而不是 Swagger UI 的 URL。

Apifox如何一键导入Swagger数据?这个问题大家知道了吧!Apifox 的整体功能比 swagger 丰富,支持一整个团队的协作,而且免费国产软件。类似swagger的工具,只能说Apifox更全面,让我找到一个合适的技术工具提高我们的效率。

官网下载地址:https://www.apifox.cn/

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 导入 OpenAPI (Swagger) 数据
  • #手动导入
  • #手动导入-文件导入
  • #手动导入-URL 导入
  • #导入-高级设置
  • #自动导入
相关产品与服务
API 网关
腾讯云 API 网关(API Gateway)是腾讯云推出的一种 API 托管服务,能提供 API 的完整生命周期管理,包括创建、维护、发布、运行、下线等。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档