Kuidas erineb OpenAPI Swaggerist? Millist versiooni kasutate?

OpenAPI on spetsifikatsioon RESTful API-de kirjelduseks, mis võimaldab standardiseerida veebiteenuste liideste kirjeldust. Swagger oli algselt tööriist ja ökosüsteem API-dega töötamiseks, sealhulgas dokumentatsiooni genereerimine, kliendi SDK-d ja serveri stub-id.

2016. aastal nimetati Swagger-spetsifikatsioon ümber OpenAPI Specification-ks (OAS) ning üle anti Linux Foundationi haldusse OpenAPI Initiative raames. Praegu on OpenAPI standard ning Swagger on tööriistade kogum, mis toetab seda standardit.

Tavaliselt kasutatakse viimast stabiilset versiooni OpenAPI Specification-ist, mis 2024. aastal on OpenAPI 3.1.x, kuna see toetab paindlikumat kirjeldust, sealhulgas täielikku JSON Schema ühilduvust.

Näide OpenAPI 3.1 kasutamisest: