SO, YOU HAVE AN API
1 You did Design-first
2 You drive Documentation from API Blueprint or Swagger
3 API Consumers have adopted it, built apps on it
Slide 4
Slide 4 text
AWESOME,
LET’S CREATE MORE!
Slide 5
Slide 5 text
10 MORE?
Slide 6
Slide 6 text
100 MORE?
Slide 7
Slide 7 text
1000???
Slide 8
Slide 8 text
HIRE MORE PEOPLE
CREATE MORE API DESIGNS
SATISFY MORE API CONSUMERS
CREATE MORE API “VERSIONS”
DEPLOY TO MORE ENVIRONMENTS
Slide 9
Slide 9 text
“Does not scale”
Slide 10
Slide 10 text
GET YOUR SANITY BACK:
TOOLS & PROCESSES
Slide 11
Slide 11 text
1
PREPA
RATIO
N
SCALE YOUR API FLOW
D
ESIG
N
&
PRO
TO
TYPE
D
EVELO
PM
EN
T
D
ELIVERY
C
O
N
SU
M
PTIO
N
A
N
A
LYSIS
2 3 4 5 6
Slide 12
Slide 12 text
CONSISTENCY
1
PREPA
RATIO
N
D
ESIG
N
D
EVELO
PM
EN
T
D
ELIVERY
C
O
N
SU
M
PTIO
N
A
N
A
LYSIS
2 3 4 5 6
Encode your Style Guide
for improved DX
Slide 13
Slide 13 text
No content
Slide 14
Slide 14 text
1
PREPA
RATIO
N
D
EVELO
PM
EN
T
D
ELIVERY
C
O
N
SU
M
PTIO
N
A
N
A
LYSIS
2 3 4 5 6
API AS A PRODUCT
D
ESIG
N
&
PRO
TO
TYPE
Slide 15
Slide 15 text
No content
Slide 16
Slide 16 text
1
PREPA
RATIO
N
CHANGE MANAGEMENT
D
ESIG
N
&
PRO
TO
TYPE
D
EVELO
PM
EN
T
D
ELIVERY
C
O
N
SU
M
PTIO
N
A
N
A
LYSIS
2 3 4 5 6
GitHub Flow
Slide 17
Slide 17 text
No content
Slide 18
Slide 18 text
AUTOMATED TESTING
1
PREPA
RATIO
N
D
ESIG
N
&
PRO
TO
TYPE
D
EVELO
PM
EN
T
D
ELIVERY
C
O
N
SU
M
PTIO
N
A
N
A
LYSIS
2 3 4 5 6
Don’t trust; verify!
Slide 19
Slide 19 text
Dredd
github.com/apiaryio/dredd
Slide 20
Slide 20 text
SOURCE OF TRUTH
1
PREPA
RATIO
N
D
ESIG
N
&
PRO
TO
TYPE
D
EVELO
PM
EN
T
D
ELIVERY
C
O
N
SU
M
PTIO
N
A
N
A
LYSIS
2 3 4 5 6
(re)use the API description
for API Management & Docs
Slide 21
Slide 21 text
No content
Slide 22
Slide 22 text
5 THINGS TO DO TODAY
• Encode your Style Guide
• Rapid Consumer Feedback!
• Use GitHub Flow
• Automate Testing (TDD/CI)
• Drive it all from API Description