实践Swagger

Swagger is the world’s largest framework of API developer tools for the OpenAPI Specification(OAS), enabling development across the entire API lifecycle, from design and documentation, to test and deployment.

swagger-architecture

Swagger Editor

在线API编写,JSON格式,符合OAS/swagger规范

Swagger UI

API文档生成、展示和功能测试

Swagger CodeGen

API相关客户端和服务端的代码生成工具

Swagger Validation

校验生成的文档说明文件是否符合语法规定的

SosoApi

由于基于OAS/swagger规范编写API,必须对规范非常熟悉,且Swagger Editor体验较差,SosoApi提升了在线编写API体验,符合OAS/swagger规范,可以理解为集成并提升了Swagger Editor和Swagger UI的功能。