YApi导入Swagger数据:手把手教你

为什么不选择 Swagger

这几天跟我同事聊了一下,他是个老后端开发了,他回忆起以前他们都是用 Swagger 这款 API 工具来管理 API 的。

然后我就问他,那为啥现在不用了呢?为啥要选择其他呢?

他列举了一些 Swagger 的缺点:

  • 界面看起来不好看
  • 数据无法进行格式化
  • 数据结构无法折叠,看起来麻烦
  • 参数问题定位起来难受

用新工具?旧数据咋办

同事说,这就涉及到 接口项目迁移 了,其实以前的人早就想到这点了,所以有比较方便快捷的办法 —— 导入导出,有了这个功能,大大降低了项目迁移时的成本

导出 Swagger 数据

操作

那要怎么导出 Swagger 的数据呢?其实很简单,Swagger 自带了导出功能,能导出一个项目的 JSON 格式文件~

结果

导出的文件,具体长这样,是一个 JSON 格式的文件,且里面是各个接口的映射:

不用 Swagger 用啥?

不用 Swagger 了,那用啥,现在很多开发都使用 YApi、Apifox。

YApi

是啥

YApi 是高效、易用、功能强大的 api 管理平台,旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API,YApi 还为用户提供了优秀的交互体验,开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。本文将带领大家搭建 YApi 接口平台。

导入 Swagger

刚刚我们已经导出了 Swagger 的 JSON 文件了,我们现在需要把这个文件导入到 YApi 中,这样才能实现项目迁移

我们需要进入 YApi 的导入界面,选择目标文件,以及覆盖模式。

然后把刚刚的 JSON 文件拖拽进去即可,成功了会提示。

Apifox 导入 Swagger

你也可以使用 Apifox 进行项目迁移,然后使用它进行 API 管理。

操作

需要进入 项目设置,然后选择需要导入的格式,Apifox 支持 20 多种导入格式,是 YApi 的好几倍!

导入

把 JSON 文件拖进去后,Apifox 会进行解析,并弹出窗口,让你选择你所需要导入的接口!!!这点就做的比 YApi 好,因为 YApi 没有这个功能,它只能导入所有~

结果

点击 确认导入,等待导入成功后,会弹出结果弹窗

并且在 接口列表 里看到导入的接口

知识扩展:

全部评论

相关推荐

点赞 评论 收藏
分享
秋招进行到现在终于能写总结了。完全没想到战线会拉这么长,过程会如此狼狈,不过更应该怪自己太菜了。好在所有的运气都用在了最后,也是有个去处。背景:双2本硕科班,无竞赛,本科一段研究所实习,硕士一段大厂暑期实习但无转正。技术栈是C++ & Golang,实习是客户端音视频(而且是鸿蒙端开发),简历两个C++项目一个Golang项目。主要投递岗位:后端,cpp软开,游戏服务端,测开,以及一些不拘泥于Java的岗位。从8月起总共投递123家公司,笔试数不清了,约面大约30家。offer/oc/意向:友塔游戏(第一个offer,面试体验很好,就是给钱好少南瑞继保(计算机科班点击就送(限男生),不...
乡土丁真真:佬很厉害,羡慕~虽然我还没有到校招的时候,也想讲一下自己的看法:我觉得不是CPP的问题,佬的背书双2,技术栈加了GO,有两段实习。投了123,面了30.拿到11个offer。这个数据已经很耀眼了。这不也是CPP带来的吗?当然也不止是CPP。至少来说在这个方向努力过的也会有好的结果和选择。同等学历和项目选java就会有更好的吗?我个人持疑问态度。当然CPP在方向选择上确实让人头大,但是我觉得能上岸,至于最后做什么方向,在我看来并不重要。至于CPP特殊,有岗位方向的随机性,java不是不挑方向,只是没得选而已。也希望自己以后校招的时候能offer满满
点赞 评论 收藏
分享
评论
点赞
收藏
分享
牛客网
牛客企业服务