Om du fortfarande inte använder ett definitionsspråk för maskinläsbara API-specifikationer, som OpenAPI (tidigare känt som Swagger), bör du definitivt överväga att göra det. När allt kommer omkring är API:er språk för maskiner att prata med varandra.
Är Swagger en bra idé?
Swagger gör ett mycket bra första intryck Dessutom tycker många att möjligheten att generera kod ur dokumentationen är en bra idé och Swagger tillhandahåller att också. Så det faktum att swagger gör ett bra första intryck, gör dess begränsningar mindre uppenbara.
Vad är syftet med att använda Swagger?
Swagger låter dig beskriva strukturen på dina API:er så att maskiner kan läsa dem. API:ers förmåga att beskriva sin egen struktur är roten till allt häftigt i Swagger.
Används Swagger fortfarande?
Idag använder många användare fortfarande termerna " Swagger" för att hänvisa till OpenAPI 2.0-specifikationsformatet och "Swagger spec" för att referera till ett API-beskrivningsdokument i detta format. RepreZen API Studio använder dessa termer i vissa delar av användargränssnittet, men refererar till OpenAPI 3.0 och senare versioner som "OpenAPI. "
Är swagger bara för REST API?
OpenAPI Specification (tidigare Swagger Specification) är ett API-beskrivningsformat för REST API:er. En OpenAPI-fil låter dig beskriva hela ditt API, inklusive: Tillgängliga slutpunkter (/users) och operationer på varje slutpunkt (GET /users, POST /users)
