Upgrade to Pro — share decks privately, control downloads, hide ads and more …

API Design Life Cycle @ Nordic APIs 2014

API Design Life Cycle @ Nordic APIs 2014

APIs are software and as such they are also a target of basic software engineering rules we are all taught for decades. Unfortunately, this fact is often ignored or forgotten and common API design process resembles an infamous waterfall model. As APIs are often sitting on boundaries between groups of developers with very different expectations and use cases, problems resulting from one-sided waterfall development are even worse than usual.

Honza’s talk will show you how to avoid waterfalls by employing iterations, prototyping, communication with client developers and testing. The last part of the presentation will be focused on how API Blueprint and its ecosystem fit into this concept and how they help to deliver APIs the right way.

Honza Javorek

October 22, 2014

More Decks by Honza Javorek

Other Decks in Technology


  1. Honza Javorek API design lover Czech Python evangelist tea &

    mate drinker sauna enthusiast sort of cartoonist Python, CoffeeScript @honzajavorek
  2. 1 what's wrong on classic API design 2 how to

    do it better 3 how can Apiary help
  3. Clientina Utvecklarsson frontend samurai mobile app hippie guerilla gardening evangelist

    chocolate core commiter Objective-C, Java, JavaScript, CoffeeScript
  4. Human usability consistency naming error prevention use case oriented helpful

    error messages help & documentation ProTip™: read Jakob Nielsen
  5. Different concerns SQL JBoss Rails maintenance latency Objective-C how to...?

    Angular jQuery learning curve examples JavaScript uptime versioning security debugging
  6. AST Documentation Mock Server Debugging Proxy Server Open Source Apiary.io

    Dredd GitHub JSON Schema Atom editor plugin Sublime Text plugin SoapUI Pro plugin