20. New:
Community-‐Driven
Website
u New
website
underway
–
hMp://swagger.io
– Github
driven
– Pages
have
a
“View
Source
on
Github”
link
– For
the
community,
BY
the
community
– Feel
free
to
contribute
content
21. June
6
Release
u SmartBear
tools
now
have
2.0
support
throughout
u Swagger
JS/UI
– Now
upgrade
older
versions
of
Swagger
2.0
before
processing
– Major
rewrites
of
the
underlying
libraries
of
these
projects
u Core
and
Codegen
– Completely
rewriMen
in
Java
(used
to
be
Scala)
– BeMer
extension
mechanism
to
allow
for
core
customiza>ons
– Codegen
has
new
templates
(Swic,
Perl,
updated
JAX-‐RS)
u Governance
– Crea>ng
an
open
governance
model
for
the
spec
– Will
involve
other
companies
and
individuals
– S>ll
figuring
out
the
exact
model
(before
the
end
of
June)
24. Design
First
API
Lifecycle
u Design
the
API
contract
u Mock
the
API
for
valida>on/collabora>on
u Test
for
compliance/completeness
u Build
the
implementa>on
u Deploy
u Manage
Fast
feedback
loops,
collabora>ve
development
25. Swagger
Support
for
Design-‐First
u Swagger
always
top-‐down
capable
u However,
tooling
focused
on
boMom-‐up
u History
of
fragmented
tool
ecosystem
29. Swagger
Tools:
Documenta>on
Swagger
Editor:
Design
your
API
using
simple
YAML
format,
preview.
Requires
the
Node.js
app.
Swagger
UI:
Display
your
documenta>on
using
sta>c
HTML
and
client-‐side
Javascript.
No
Node.js
required.
33. Op>on
2:
Install
and
Customize
hMps://github.com/swagger-‐api/swagger-‐generator
hMps://github.com/swagger-‐api/swagger-‐editor
34. Editor
Extensions
Swagger
Editor
Callbacks:
Callbacks
for
integra>ng
with
design/deploy
workflows.
Swagger
Editor
Storage:
Backend
support
using
GET
and
PUT
for
retrieving
and
saving
YAML
defini>ons.
35. How
to
Get
Started
with
Swagger
u Use
the
Swagger
Editor
to
view
samples
u In
parallel,
read
the
Swagger
2.0
Spec
to
understand
samples
in-‐depth
u Reverse-‐engineer
exis>ng
API
or
third-‐party
API
into
Swagger
u Publish
using
Swagger-‐UI
u Try
one
of
the
client
code
generators
(some
beMer
than
others)
36. Thanks
Ya’ll
James
Higginbotham
james@launchany.com
hMp://launchany.com
@launchany