Your SlideShare is downloading. ×
Art of Building APIs
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×

Introducing the official SlideShare app

Stunning, full-screen experience for iPhone and Android

Text the download link to your phone

Standard text messaging rates apply

Art of Building APIs

986
views

Published on

My short talk on problems designing and building successful APIs, presented first at API Strategy Conference in New York

My short talk on problems designing and building successful APIs, presented first at API Strategy Conference in New York

Published in: Technology

0 Comments
2 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
986
On Slideshare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
25
Comments
0
Likes
2
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. THE ART OF BUILDING APIS Jakub Nesetril founder & CEO of Apiary
  • 2. ONE SIZE DOES NOT FIT ALL There is no simple way to solve API design. Different groups of developers has different needs, usecases and workflows.
  • 3. ART, NOT ROUTINE API is and interface. In 2000’s, we thought it was machine- machine interface. But in 2010’s, we know that it’s the interface to the developer behind the machine. Thus, building APIs is a lot like building UIs.
  • 4. UI design is dominatedby user-centered design.It involves the user intodesign workflow as soonas possible, often usingwireframes.
  • 5. But API design is stilllargely a waterfallapproach - design-build-document everythingupfront. Only theninvolve the user.
  • 6. Mock > Use > ImplementUsing a mock serverallows to change theworkflow: produce awireframe quickly, theninvolve the customer.Implement once the apiary.iodesign is finalized.
  • 7. Mock > Use > ImplementUsing a mock serverallows to change theworkflow: produce awireframe quickly, theninvolve the customer.Implement once the apiary.iodesign is finalized.
  • 8. API BLUEPRINTHOST: http://api.twitter.com/ Apiary.io has a quick--- Twitter API 3.0 --- tool for describing APIs--- using a very light-weight DSL called APIWelcome to our API. Comments support Markdown syntax Blueprint.----- Retrieve Tweets --GET /tweets> Accept: application/json< 200< Content-Type: application/json{ "items": [ { "url": "/feed", "range":"2ZY48XPZ", "quantity": 1, "name": "Newsocks", "price": 1.25 }] }
  • 9. Mock > Use > Implement Using this more structured approach gives you more benefits at once. Once you finish designing, your documentation and test suite are in sync.Testing Documentation apiary.io
  • 10. TESLA MODEL SAmong other APIsthat weredocumented inApiary was TeslaModel S.
  • 11. apiary.ioE-MAIL jakub@apiary.io TWITTER @apiaryio
  • 12. PHOTO CREDITShttp://www.flickr.com/photos/ironrodart/4308675209/sizes/o/http://www.flickr.com/photos/30030574@N03/3633431964/