swagger
前言
小编前几天在学习了swagger,一直都处于迷迷糊糊的,不太明白他的优势,单纯的认为只是提供给我们一个界面用于前后台的交互,其实还有很多其他的功能
What Swagger
swagger表示用于前后端分离,接口管理和测试工具集,Swagger规范定义了一系列的文件,用以描述API,这些文件被Swagger-ui显示用于展示API,也可以用于被Swagger-Codegen项目用于生产代码,我们使用Swagger进行APIDE设置
他可以帮助我们再看不到代码和源码的情况下,把我们我们去理解功能,调用我们的接口
Where Swagger
openapi的前身是swagger规范
How Swagger
可以用json和YaML,另一种标记语言,可以被电脑直观识别的数据序列化格式
Swagger是描述REST API格式的一组规则(换言之,规范)。该格式是机器可读的和人类可读的。因此,它可以用来在产品经理,测试人员和开发人员之间共享文档,但也可以被各种工具用来自动执行与API相关的过程。
Swagger编辑器 - 一个基于浏览器的编辑器,您可以在其中编写OpenAPI规范。
Swagger UI - 将OpenAPI规范呈现为交互式API文档
Swagger Codegen - 根据OpenAPI规范生成服务器代码和客户端库。
Why Swagger
人机交互,自动生成交互式API文档,以查看API的实际操作。
围绕这个框架的大型综合工具生态系统,可以让从SDK生成到测试和调试,不仅仅是设计。
强大的开源社区支持和领导框架。
区分
Swagger==实用工具
OpenAPI=规范
OpenAPI的规范是由该计划涉及来自技术领域不同领域的30多个组织,包括微软,Google,IBM和CapitalOne进行推动的,领导Swagger也是OpenAPI计划的成员,Swagger是用于实现OpenAPi规范的工具
Why Swagger工具没有改名为OpenAPI
Swagger具有Swagger UI,Swagger Editor和Swagger Codegen核心开发工具组成,由于有大量的开发人员,技术编写人员,测试人员和设计人员所以Swagger工具仍然保留了原有的品牌,虽然Swagger没有改名字但是Swagger会继续遵从OpenAPI的规范设计
转载自: HTTPs://blog.csdn.net/dtttyc/article/details/78797546?foxhandler=RssReadRenderProcessHandler