Victor Augusteo gives a presentation on streamlining APIs with Swagger.io. He introduces Swagger and its components for code generation, UI documentation, and editing OpenAPI specification files. Swagger can standardize API development by generating server and client code from specifications. It provides a single source of truth and makes communication between frontend and backend engineers more effective. He demonstrates locally running Swagger Editor to create an API spec and generate a Ruby server stub and Swift client code.

1. STREAMLINING API WITH
SWAGGER.IO
VICTOR AUGUSTEO

2. SHORT PROFILE
▸ Victor Augusteo
▸ Frontend engineer @ PwC Experience Centre
▸ Mostly iOS and web apps
▸ augusteo@gmail.com
▸ linkedin.com/in/victoraugusteo

3. QUICK OVERVIEW
▸ 2 parts talk
▸ intro to swagger
▸ live demo
▸ for front, back-end and test engineers
▸ how swagger would be useful for you
▸ be aware that it is an option

4. CONVENTIONAL API LIFECYCLE
BACKEND
IMPLEMENTS API
BACKENDS TELLS
FRONTEND THE
DETAILS
FRONTEND
CONSUMES THE
API

5. OR THE OTHER WAY AROUND
FRONTEND TELLS
BACKEND WHAT
API IT NEEDS
BACKEND
IMPLEMENTS API
FRONTEND
CONSUMES THE
API

6. USUALLY RESULTING IN
▸ lots of back and forth between frontend-backend
▸ non-standardized api style (usually)
▸ extra step to write documentation outside codebase
▸ multiple sources-of-truth
▸ need to test using REST clients like curl or Paw

8. WOULDN’T IT BE AWESOME
FOR A TOOL TO SOLVE ALL
OUR PROBLEMS?

9. ENTER SWAGGER.IO

10. SO WHAT IS IT?
▸ swagger
▸ codegen
▸ ui
▸ editor
▸ OpenAPI-Spec

11. SWAGGER
▸ the brain - generates and consume swagger file
▸ java, js, node authored by the swagger team
▸ and many community driven language integrations

12. CODEGEN
▸ stub code generator for server and client

13. UI
dependency-free html for api documentation and sandbox,
serves as the contract between front/backend devs

14. EDITOR
live edit swagger file (JSON/YAML), codegen, example, etc.

15. OPENAPI SPECIFICATION
‣ a set of standards on how to write your api
‣ popular ~ 3000 ⭐on github, backed by Linux foundation

16. HOW DO YOU USE IT?
▸ start with swagger definitions, generate the server & client
code then flesh out the implementations
▸ if you have existing project and you are using supported
frameworks, then swagger definitions can be automatically
generated for you given you write swagger comments in
the API points
▸ Node, Java, JS, .Net, PHP, Python, Ruby, Scala, etc.
▸ full list @ http://swagger.io/open-source-integrations/

17. QUICK LIVE DEMO!
▸ run swagger-editor locally
▸ use swagger editor to create api spec
▸ hello world api & sum two numbers api
▸ generate server stub in Ruby Sinatra and run it on
localhost
▸ consume the api with generated Swift client

19. 1. RUN SWAGGER-EDITOR LOCALLY

20. SWAGGER HELPS US TO
▸ communicate more effectively
▸ standardized api across engineers
▸ easy to use generated documentation
▸ single source of truth
▸ built in REST client to test

21. RESOURCES LINKS
▸ http://swagger.io
▸ https://github.com/OAI/OpenAPI-Specification
▸ email me augusteo@gmail.com
▸ connect on linkedin.com/in/victoraugusteo

22. QUESTIONS ?
I HAS BEEN AN HONOR!