Middle
Aký je rozdiel medzi OpenAPI a Swagger? Akú verziu používate?
sobes.tech AI
Odpoveď od AI
OpenAPI je špecifikácia na opis RESTful API, ktorá umožňuje štandardizovať opis rozhraní webových služieb. Swagger bol pôvodne nástroj a ekosystém na prácu s API, vrátane generovania dokumentácie, klientských SDK a serverových stubov.
V roku 2016 bola špecifikácia Swagger premenovaná na OpenAPI Specification (OAS) a prevedená pod správu Linux Foundation pod záštitou OpenAPI Initiative. Dnes je OpenAPI štandardom a Swagger je súbor nástrojov, ktoré tento štandard podporujú.
Zvyčajne sa používa posledná stabilná verzia OpenAPI Specification, ktorá v roku 2024 je OpenAPI 3.1.x, pretože podporuje flexibilnejší opis vrátane úplnej kompatibility s JSON Schema.
Príklad použitia OpenAPI 3.1: