api design & the paris subway

33
API Design & The Paris Subway Bruno Pedro December 2014

Upload: bruno-pedro

Post on 04-Jul-2015

1.091 views

Category:

Technology


4 download

DESCRIPTION

APIdays Paris 2014 Presentation comparing the design of the Paris transportation network and how to design your API.

TRANSCRIPT

Page 1: Api Design & The Paris Subway

API Design &The Paris Subway

Bruno Pedro December 2014

Page 2: Api Design & The Paris Subway

Bruno Pedro

@bpedrobrunopedro.com

API Changelog

Page 3: Api Design & The Paris Subway

Increasing Traffic

Page 4: Api Design & The Paris Subway

London Subway

Page 5: Api Design & The Paris Subway

NYC Subway

Page 6: Api Design & The Paris Subway
Page 7: Api Design & The Paris Subway

Fulgence Bienvenüe

Page 8: Api Design & The Paris Subway

Fulgence Bienvenüe

Page 9: Api Design & The Paris Subway

July 1900

Page 10: Api Design & The Paris Subway

}

Page 11: Api Design & The Paris Subway
Page 12: Api Design & The Paris Subway
Page 13: Api Design & The Paris Subway
Page 14: Api Design & The Paris Subway
Page 15: Api Design & The Paris Subway
Page 16: Api Design & The Paris Subway
Page 17: Api Design & The Paris Subway
Page 18: Api Design & The Paris Subway

the public face of Paris transports

transport organization authority

independent organization

coordinates different transport companies

Page 19: Api Design & The Paris Subway
Page 20: Api Design & The Paris Subway
Page 21: Api Design & The Paris Subway

Usability

Page 22: Api Design & The Paris Subway

Interoperability

Page 23: Api Design & The Paris Subway

Creativity

Page 24: Api Design & The Paris Subway

Usability

Functionality

Reliability

Proficiency

Creativity

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

Page 25: Api Design & The Paris Subway
Page 26: Api Design & The Paris Subway

martinfowler.com/articles/microservices.html

Page 27: Api Design & The Paris Subway

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

Page 28: Api Design & The Paris Subway

Service A Service CService B

DB QUEUE MSG API

Page 29: Api Design & The Paris Subway

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

Page 30: Api Design & The Paris Subway

mmmInteroperability

use well known standards

publish machine-readable documentation

test your API regularly

manage your API usage

Page 31: Api Design & The Paris Subway

Creativity

use less strict terms of use

promote innovation with hackathons, etc.

communicate with your audience

showcase creations with a marketplace

Page 32: Api Design & The Paris Subway

Usability

Functionality

Reliability

Proficiency

Creativity

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

Page 33: Api Design & The Paris Subway

Bruno Pedro

@bpedrobrunopedro.com

Thank You!is hiring!