Skip to main content

Integration & IT Modernization

API Best Practices from Successful API Teams

The API management software company 3scale has put together a free ebook (requires an email address) The API Owner’s Manual that including best practices from successful API teams.

The book recommends using Alexander Osterwalder’s Business Model Canvas to define the business case for API offerings. The Business Model Canvas defines a structured way to analyze core aspects of an API program such as value proposition, revenue streams, cost structure, customer segments, channels, etc.

The book is loaded with tips and case studies and is a quick read. Definitely worth the time to download and check out.

From the download site and book:

Learn how successful API programs are built and managed, along with best practices that help to enable success. This ebook examines a number of examples of successful API programs, including Amazon, APIdaze, eBay, Flickr, Netflix, Pingar, SendGrid, Senzari MusicGraph, Stripe, and Twilio.

Best practices from successful API teams

  1. Focus relentlessly on the value of the API

  2. Make the business model clear from the beginning

  3. Design and implement with the user in mind

  4. Place API operations at the top of the list

  5. Obsess about developer experience

  6. Go beyond marketing 101

  7. Remember API retirement and change management


Our team has also put together an ebook on how to get started with APIs. Download the guide for the steps to create a successful API strategy to fuel innovation and digital transformation.

Thoughts on “API Best Practices from Successful API Teams”

  1. Hi Eric,

    thanks a lot for this article and mentioning our ebook. In the meantime we evolved the idea of using Osterwalder’s Business Model Canvas to an API Model Canvas, which should help organisations creating an API program.

    We presented this concept at the API Strategy and Practice (APIStrat) conference 2015 in Austin. Here are video and slides:

    Currently, we are developing this into an open-source tool.


Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Eric Roch, Chief Strategist, IT Modernization & Integration

More from this Author

Follow Us