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 grensesnitt fil, 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]
Referanser
- ^ «Swagger creator joins SmartBear». Besøkt August 6, 2019. Sjekk datoverdier i
|besøksdato=(hjelp) - ^ «Linux Foundation wants to extend Swagger in connected buildings | Business Cloud News». Arkivert fra originalen 6 May 2016. Besøkt 22. april 2016. Sjekk datoverdier i
|arkivdato=(hjelp) - ^ «SmartBear Assumes Sponsorship of Swagger API Open Source Project». Besøkt 25. mars 2015.
- ^ «OpenAPI Initiative Charter». Besøkt 12 November 2019. Sjekk datoverdier i
|besøksdato=(hjelp) - ^ a b «swagger-api/swagger-spec». Besøkt 1. desember 2015.