api design & the paris subway
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](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/1.jpg)
API Design &The Paris Subway
Bruno Pedro December 2014
![Page 2: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/2.jpg)
Bruno Pedro
@bpedrobrunopedro.com
API Changelog
![Page 3: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/3.jpg)
Increasing Traffic
![Page 4: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/4.jpg)
London Subway
![Page 5: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/5.jpg)
NYC Subway
![Page 6: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/6.jpg)
![Page 7: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/7.jpg)
Fulgence Bienvenüe
![Page 8: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/8.jpg)
Fulgence Bienvenüe
![Page 9: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/9.jpg)
July 1900
![Page 10: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/10.jpg)
}
![Page 11: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/11.jpg)
![Page 12: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/12.jpg)
![Page 13: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/13.jpg)
![Page 14: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/14.jpg)
![Page 15: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/15.jpg)
![Page 16: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/16.jpg)
![Page 17: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/17.jpg)
![Page 18: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/18.jpg)
the public face of Paris transports
transport organization authority
independent organization
coordinates different transport companies
![Page 19: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/19.jpg)
![Page 20: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/20.jpg)
![Page 21: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/21.jpg)
Usability
![Page 22: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/22.jpg)
Interoperability
![Page 23: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/23.jpg)
Creativity
![Page 24: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/24.jpg)
Usability
Functionality
Reliability
Proficiency
Creativity
Interoperability}apiux.com/2013/05/29/api-hierarchy-needs/
![Page 25: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/25.jpg)
![Page 27: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/27.jpg)
martinfowler.com/articles/microservices.htmlpicture courtesy Dave Thomas
![Page 28: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/28.jpg)
Service A Service CService B
DB QUEUE MSG API
![Page 29: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/29.jpg)
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](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/30.jpg)
mmmInteroperability
use well known standards
publish machine-readable documentation
test your API regularly
manage your API usage
![Page 31: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/31.jpg)
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](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/32.jpg)
Usability
Functionality
Reliability
Proficiency
Creativity
Interoperability}apiux.com/2013/05/29/api-hierarchy-needs/
![Page 33: Api Design & The Paris Subway](https://reader033.vdocuments.mx/reader033/viewer/2022060123/559788e81a28ab835a8b45d7/html5/thumbnails/33.jpg)
Bruno Pedro
@bpedrobrunopedro.com
Thank You!is hiring!