API Design Tutorial: The Interaction Model

API design can be daunting. With so many decisions to make and so many differing opinions available on interface design, it's easy to feel frustrated by the process.  Even worse, it's possible to follow bad advice and end up designing an API that developers hate using.

That's why we at the API Academy stress the importance of making rational decisions rather than irrationally selecting design patterns based on emotion or trends.  We want you to choose your design elements rather than picking them from the latest set of formats or technologies that you've heard about. And that's why we're working on a series of tutorial videos, as my colleague Mike Amundsen recently announced.

The first of these videos, titled The API Interaction Model - An Introduction, provides an overview of  a design process that will help you consider your user's perspective in order to make effective design choices later. The ideas I discuss in this video are rooted in user-centered design processes that have been very effective in the software and product design worlds. If you're currently designing an API, invest five minutes and watch the video.  It should be time well spent.

[embed]https://www.youtube.com/watch?v=vINyz_lWzCQ[/embed]

The Author

Ronnie Mitra

Lead Designer

Ronnie Mitra is an expert in enterprise development and integration who leads the CA Technologies API Architecture and Design Practice across Europe. In this role, Ronnie helps companies leverage their burgeoning API potential. Before joining CA, he worked at IBM where he held the worldwide leadership role for WebSphere connectivity products.

Related Articles

Microservices

Applying and Extending DHARMA

This post gives some practical examples of the DHARMA method for API Security in a Microservice Architecture, and also shares some opportunities for extending the model.

Matt McLarty on Jul 9, 2018

Microservices and APIs
API Strategy

Microservices, APIs and Innovation: The Power of APIs

Explore the role APIs play in empowering teams and enabling organizations to innovate.

Mike Amundsen on May 24, 2018

How API Languages Evolve
API Design

How API Languages Evolve

As API systems mature, knowing the history and evolution of various API languages will help organizations create robust and successful landscapes.

Erik Wilde on Oct 17, 2017

Join the Conversation