API Design 202: Architectural Layers

No matter what API design style you choose, there are certain key qualities you will want your interface to have. Designing API architecture able to encompass all these qualities can be challenging. In this lesson, we outline a layered architectural style that simplifies the process of implementing a full-functioned Web API design. For a Web […]

API Design 101: API Design Basics

The term “API design” or “API architecture” refers to the process of developing a software interface that exposes backend data and application functionality for use in new applications. In this lesson, we provide an overview of the API architecture process, as a starting point for a deeper exploration of design and implementation best practices in […]

API Design 201: Web API Architectural Styles

Generally speaking, the term “Web API” describes any software interface that is exposed over the Web using the HTTP protocol in order to facilitate application development (but not limited to any particular message format, pattern or implementation). In this lesson, we provide a detailed overview of the main Web API design styles: Tunneling (aka Web Service); […]

Client-Optimized Resource Representations in APIs

Create tiered representations of responses to optimize your API for mobile clients One of the most important design principles for an API program is to embrace that APIs are products. It follows that successful APIs, much like products, must provide user-optimized experiences. Case in point: it is clearly inappropriate to send large response payloads to a […]

Coordinating a Well-Rounded API Program

Creating a well-rounded API program requires coordination between stakeholders with different frames of reference The API Academy is committed to promoting a 360-degree approach to APIs – one that encompasses business strategy, interface design and long-term management. This approach doesn’t simply reflect the interests of the Academy’s experts or the range of services they offer. The fact […]

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 […]

The Art of Effective API Design

This presentation was recorded at the 2014 Nordic APIs Platform Summit in Stockholm. It is known that an API designer’s goal has evolved to a more developer-centric model. However, the design process has evolved at a slower pace, often resulting in an interface that under-delivers on the initial usability goal. Is there an opportunity to […]