OpenAPI Specification
OpenAPI Specification, tidligere kjent som Swagger Specification,[1] er en teknisk spesifikasjon for maskinlesbare grensesnittfiler for å beskrive, produsere, konsumere og visualisere RESTful-nettjenester.[2] Tidligere var spesifikasjonen en del av Swagger-rammeverket utviklet av SmartBear Software.[3] I 2016 kom den inn som et eget prosjekt i samarbeidsprosjektet OpenAPI Initiative som er et samarbeid for åpen kildekode under Linux Foundation.[4] Swagger og andre lignende verktøy kan, gitt en grensesnittfil, generere kode, dokumentasjon og testtilfeller.
Programmer som er basert på OpenAPI-grensesnittfiler kan automatisk generere dokumentasjon av metoder, parametre og modeller. Dette bidrar til å holde dokumentasjon klientbiblioteker og kildekode oppdatert.[5] Swagger kan håndtere både JSON og XML.[5]
Se også
- REST
Referanser
- ^ «Swagger creator joins SmartBear». Besøkt 6. august 2019.
- ^ «Linux Foundation wants to extend Swagger in connected buildings | Business Cloud News». Arkivert fra originalen 6. mai 2016. Besøkt 22. april 2016.
- ^ «SmartBear Assumes Sponsorship of Swagger API Open Source Project». Besøkt 25. mars 2015.
- ^ «OpenAPI Initiative Charter». Besøkt 12. november 2019.
- ^ a b «swagger-api/swagger-spec». Besøkt 1. desember 2015.