api design & the paris subway

API Design &The Paris Subway

Bruno Pedro December 2014

Bruno Pedro

@bpedrobrunopedro.com

API Changelog

Increasing Traffic

London Subway

NYC Subway

Fulgence Bienvenüe

Fulgence Bienvenüe

July 1900

}

the public face of Paris transports

transport organization authority

independent organization

coordinates different transport companies

Usability

Interoperability

Creativity

Usability

Functionality

Reliability

Proficiency

Creativity

Interoperability}apiux.com/2013/05/29/api-hierarchy-needs/

martinfowler.com/articles/microservices.html

martinfowler.com/articles/microservices.htmlpicture courtesy Dave Thomas

Service A Service CService B

DB QUEUE MSG API

Usability

understand your API in 3 seconds

identify the endpoint in 30 seconds

consume it in less than 3 minutes

Ori Pekelman’s 3:30:3 Rule

mmmInteroperability

use well known standards

publish machine-readable documentation

test your API regularly

manage your API usage

Creativity

use less strict terms of use

promote innovation with hackathons, etc.

communicate with your audience

showcase creations with a marketplace

Usability

Functionality

Reliability

Proficiency

Creativity

Interoperability}apiux.com/2013/05/29/api-hierarchy-needs/

Bruno Pedro

@bpedrobrunopedro.com

Thank You!is hiring!