Swagger is an open source software framework backed by
a large ecosystem of tools that helps developers
design, build, document and consume RESTful Web
services.
2. Agenda
● Introduction
● What is swagger
● Why swagger
● Documentation approaches
○ API specification first
○ Implementation first
2
3. ● Swagger is an open source software framework backed by
a large ecosystem of tools that helps developers
design, build, document and consume RESTful Web
services.
● Use OpenApi Specification (OAS)
● Developed by SmartBear Software.
● Apache License 2.0 licensed
● Released in 2011
3
Introduction
4. Swagger is...
TECHNOLOGY
A framework for :
● Producing
● Consuming
● Visualizing
REST-full APIs
METHODOLOGY
A specification for :
● Describing
● Documentaing
REST-full APIs
4
5. Why swagger
● Standard documentation
● Manage ad-hoc attributes
● Auto generated docs
● Up to date
These reasons are only for API doc, there are many more
things we can do with swagger
5
6. Place your screenshot here
Have a look...
That is how
swagger console
look, with our
API spec and
generated UI 6
16. Swagger- core Annotations
16
● @Api
● @ApiImplicitPara
m
● @ApiImplicitPara
ms
● @ApiOperation
● @ApiParam
● @ApiResponse
● @ApiResponses
● @ApiModel
● @ApiModelProper
ty
17. Swagger in lending mantra
Another approach : How we integrated
swagger in our application
18. Credits
Special thanks to all the people who made and released these
awesome resources for free:
● OpenApi spec
● Understanding $ref
● All about annotations
● Integrating Swagger-UI with Grails Application
● spring fox plugin documentation
18