https://slides.com/coreybutler/deck/live
Follow along live at:
The Art of
API
Blue slides = Take Away
REMEMBER...
What is an API?
VS
Oracle vs Google
Oracle vs Google
Oracle vs Google
Oracle vs Google
Oracle vs Google
Oracle vs Google
is an API....
- REST?
- AJAX?
- Web Sockets?
- Microservices?
- [INSERT BUZZWORD HERE]?
A set of routines, protocols, and tools for building software applications.
Do we trust wikipedia?
Wikipedia Says:
No
(well, maybe a little bit)
API's are Human
Programmers Make API'S.
On one hand:
Programmers consume API'S
(and coffee)
On the other hand:
Programmers are People
(not just coffee-to-code conversion units)
Design for People
REMEMBER TO...
How do we Qualify Success?
-
Tell a Story
-
Sign the Contract
-
Let the Work Flow
Start with a Story
What motivates programmers?
Title Text
Title Text
Title Text
Don't be prejudice.
Prejudice: preconceived opinion that is not based on reason or actual experience
Title Text
Motivation
Sometimes
is found between the lines.
Motivator: Capability
Design narratively
REMEMBER TO...
-
TOLD a Story
-
Sign the Contract
-
Let the Work Flow
Contract?
Obvious = Foundation
-
TOLD a Story
-
Legally Bound
-
Let the Work Flow
The best way to build API trust is.......
anticipation builds....
anticipation builds some more...
anticipation builds even more...
Man, this better be good.
Like, this better be something every developer has been wanting to hear their entire life.
I'M SO EXCITED!
Documentation
Documentation-First
REMEMBER...
Oh god, he even put it on a blue slide. He actually wants me to write docs?!
Generate Docs
Add this to your build process now!
Documentation is the bridge between planning and doing.
Build Your Workflow, so you can do faster.
Unit Testing!
API Unit Testing is Hard!
(but not impossible)
Tough becomes Trust
Release When Ready
(continuous deployment is your friend)
Win with Continuous Workflow
REMEMBER...
-
Tell a Story
-
Sign the Contract
-
Let the Work Flow
REMEMBER TO...
-
Design For People
-
Design Narratively
-
Document-First
-
Win with Continuous Workflow
THINK ABOUT...
QUESTIONS?
Twitter: @goldglovecb
API
By Corey Butler
API
- 1,066