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?

  1. Tell a Story

  2. Sign the Contract

  3. 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...

  1. TOLD a Story

  2. Sign the Contract

  3. Let the Work Flow
     

Contract?

Obvious = Foundation

  1. TOLD a Story

  2. Legally Bound

  3. 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...

  1. Tell a Story

  2. Sign the Contract

  3. 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