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

API Design Lifecycle @ Rubyslava Conf'15

API Design Lifecycle @ Rubyslava Conf'15

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. First part of my talk will show you how to avoid waterfalls by employing iterations, prototyping, communication with client developers and testing. The second 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. I'll present new API Blueprint and Apiary features and I'll also give some sneak peeks on still to be announced features (shshshsh!), which can help you to get the most from the API Blueprint and Apiary.

Honza Javorek

June 19, 2015

More Decks by Honza Javorek

Other Decks in Technology


  1. Czech Python Community Mascot API design lover Honza Javorek honzajavorek.cz

    @honzajavorek sort of cartoonist beverage-agnostic caffeine consumer
  2. 1 what's wrong on classic API design 2 how to

    do it better 3 how can Apiary help
  3. 70s 40 years ago Karel Gott Waldemar Matuška Blue Effect

    Helena Vondráčková Miroslav Žbirka waterfall model coined AC/DC Led Zeppelin
  4. Human helpful error messages consistency error prevention usability naming ProTip™:

    read Jakob Nielsen use case oriented help & documentation
  5. Different concerns maintenance Rails SQL JBoss uptime security Objective-C latency

    JavaScript how to…? jQuery Angular examples learning curve debugging
  6. Documentation Tests Mock Server Debugging Proxy Server GitHub JSON Schema

    Sublime Text Plugin Style Checking Atom Plugin Node.js binding Ruby binding Validation Vim Plugin SoapUI Plugin Hypermedia Open Source apiblueprint.org language-agnostic
  7. Image Credits Leonardo da Vinci - Le proporzioni del corpo

    umano secondo Vitruvio, 1490 Honza Javorek - arbitrary cartoons, 2O14 and 2015