OpenAPI Kullanımı

OpenAPI Nedir

Açıklaması şöyle

The OpenAPI specification defines how to write HTTP APIs that can be consumed by any programming language and provide insight into the APIs’ functionality without access to source code or documentation. In other words, following the specification makes it easier for consumers to understand what it does and how to use it. Tools, such as Swagger, can then be used to display documentation without developers maintaining documentation separate from an API’s code.

All these described points translate into happier users while mitigating some of the burdens you’ll face while supporting your APIs.

Openapi-processor

İlk defa burada gördüm. Maven veya Gradle kullanarak YAML dosyasından Spring sınıflar üretebiliyor

OpenAPI vs Swagger

Açıklaması şöyle

Evolution from Swagger to OpenAPI

Swagger was initially released in 2011 as a specification and a large ecosystem for building API-related tools (documentation, client SDK generation, etc.). In 2015, the Swagger Specification was donated to the OpenAPI Initiative, becoming the foundation of the OpenAPI Specification (OAS). This marked the evolution of Swagger to OpenAPI, although the term “Swagger” is still commonly used when referring to the tools and ecosystem, whereas “OpenAPI” refers to the specification itself.

Açıklaması şöyle

Although the terms once referred to the same thing, they can no longer be used interchangeably…even though some people still do, in 2021 OpenAPI refers to the industry-standard specification for RESTful API design. Swagger refers to a set of SmartBear tools.

OpenAPI'yi gerçekleştiren kütüphaneler şeklen şöyle

Springfox Gerçekleştirimi

Swagger (OpenAPI ) Kullanımı yazısına taşıdım

SpringDoc Gerçekleştirimi

SpringDoc OpenAPI Kullanımı yazısına taşıdım