Care este diferența dintre OpenAPI și Swagger? Ce versiune folosiți?

OpenAPI este o specificație pentru descrierea API-urilor RESTful, care permite standardizarea descrierii interfețelor serviciilor web. Swagger, pe de altă parte, a fost inițial un instrument și un ecosistem pentru lucrul cu API-uri, inclusiv generarea de documentație, SDK-uri client și stub-uri server.

În 2016, specificația Swagger a fost redenumită în OpenAPI Specification (OAS) și transferată în administrarea Linux Foundation sub egida OpenAPI Initiative. În prezent, OpenAPI este un standard, iar Swagger este un set de instrumente care susțin acest standard.

De obicei, se folosește cea mai recentă versiune stabilă a OpenAPI Specification, care în 2024 este OpenAPI 3.1.x, deoarece suportă o descriere mai flexibilă, inclusiv compatibilitate completă cu JSON Schema.

Exemplu de utilizare a OpenAPI 3.1: