Sobes.tech
Middle

Čím se OpenAPI liší od Swaggeru? Jakou verzi používáte?

sobes.tech AI

Odpověď od AI

OpenAPI je specifikace pro popis RESTful API, která umožňuje standardizovat popis rozhraní webových služeb. Swagger byl původně nástroj a ekosystém pro práci s API, včetně generování dokumentace, klientských SDK a serverových stubů.

V roce 2016 byla specifikace Swagger přejmenována na OpenAPI Specification (OAS) a převedena pod správu Linux Foundation pod záštitou OpenAPI Initiative. Dnes je OpenAPI standardem a Swagger je soubor nástrojů podporujících tento standard.

Obvykle se používá poslední stabilní verze OpenAPI Specification, která v roce 2024 je OpenAPI 3.1.x, protože podporuje flexibilnější popis včetně úplné kompatibility s JSON Schema.

Příklad použití OpenAPI 3.1: