Swagger in the API Lifecycle

16
SWAGGER IN THE API LIFECYCLE Ole Lensmar, CTO, SmartBear Software

Transcript of Swagger in the API Lifecycle

Page 1: Swagger in the API Lifecycle

SWAGGER IN THE API LIFECYCLEOle Lensmar, CTO, SmartBear Software

Page 2: Swagger in the API Lifecycle

What is Swagger?

Page 3: Swagger in the API Lifecycle
Page 4: Swagger in the API Lifecycle

Swagger Specification

Page 5: Swagger in the API Lifecycle

Swagger UI

Page 6: Swagger in the API Lifecycle

Swagger Editor

Page 7: Swagger in the API Lifecycle

Swagger Core

Page 8: Swagger in the API Lifecycle

Swagger Codegen

Page 9: Swagger in the API Lifecycle

Swagger on GitHub

Page 10: Swagger in the API Lifecycle

Swagger Community

Page 11: Swagger in the API Lifecycle

Vendors, tools, community etc…

Page 12: Swagger in the API Lifecycle

What about SmartBear?

Official “steward” of the Swagger project – (since about a month)

Ensure Swaggers continued success

Put development and marketing resources behind open source components

(Commercial support offerings / products)

Page 13: Swagger in the API Lifecycle

Swagger in the API Lifecycle

Design / Code – swagger editor/core/codegen

Virtualize – adjacent tools

Test –adjacent tools

Document – swagger-ui

Deploy – adjacent tools

Monitor – adjacent tools

Page 14: Swagger in the API Lifecycle

API Design approaches

Top-Down – create spec in editor, generate code with codegen

Bottom up – write code – generate Swagger with swagger-core

Hybrid– Start with Top-down for prototype– Continue with Bottom-up for “evolution”

Page 15: Swagger in the API Lifecycle

Swagger in the API dev process

OPS

Dev/QA

Backend Dev

Swagger

Virtualized API

API Implementation Production API

Client Dev

Production Client

Continuous Integration / Deployment

Functional, Load, Security Testing

Client Application

Page 16: Swagger in the API Lifecycle

Thank you!

Ole Lensmar@olensmar