Skip to content


Explore our extensive library of articles, lessons, books, whitepapers, and videos.

Explore Featured Posts About APIs and Microservices

Explore by Topic

API Design 101: API Design Basics

By pwsadmin | April 23, 2015 |

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…

Latest Articles

API World 2019

API World 2019: Event Recap

By Jaime Ryan | October 21, 2019 |

For the last eight years, API practitioners and vendors have descended on San Jose, right down the road from the Broadcom headquarters, for the annual API World conference. This year, the Layer7 API Management team was joined at the show by our colleagues from Continuous Testing and AIOps to talk about full lifecycle API Management.…

Should Your API Gateway be Considered Part of Your API Management Platform?

By Geoff Duck | October 17, 2019 |

Recently at API world I was able to see many new Enterprise API architectures (“marketechtures,” as one engineering director called it, got few laughs but I chuckled quietly to myself) including some high-level diagrams from large well-known providers of services leveraged by enterprises and common end-users alike. Several companies separate the concept of API Gateways…

DevOps: REST API Execution Through Bash Shell Scripting

By Thomas Cheng | October 2, 2019 |

A Simple Framework: Core This is the first part of a paper proposing a framework that enables DevOps teams to issue REST API calls via bash shell scripts. The second part of the paper discusses the extension beyond the core of the proposed framework. The third part shares some experiences learned from real world applications.…

Alexa, start the car: IoT in the automotive industry

By Charlotte | July 16, 2019 |

How APIs fuel the connected car and why security is essential to IoT development From the outside, today’s cars look similar to their counterparts from 10 or even 20 years ago. But on the inside, they have been transformed by technology. Cars have retained their core functionality, but integrated connectivity, sensors, and systems have led…

APIs and the Smart City

By Amy Vujanich | July 19, 2018 |

Exploring the role of APIs in enabling smart city initiatives As cities grow and evolve, so do the issues that local governments need to address. Leveraging technology to provide public services more efficiently and intelligently is one approach that dozens of cities across the globe are doing. Examples include everything from connected streetlights to full-service…

The Internet of Things – Today

By Bill Oakes, CISSP | March 10, 2014 |

A quick intro: I’m Bill Oakes, I work in product marketing for CA and I was recently elected to write a regular blog about the business of APIs. I’ve been around the block over the years – a coder, an engineer… I even wrote a BBS once upon a time (yes, I’m pre-Web, truly a dinosaur –…

How I Lost Weight & Learned About APIs

By Ronnie Mitra | December 2, 2013 |

Trying to stay in shape is one of those never-ending life battles that I’ve come to expect as I get older. I’ve bounced between being a healthy shape and a not-so-healthy one for years and I’ve managed to live life just outside the edge of ideal fitness. A few months back, I reached an apex…

Cyber Security Awareness Month & the Internet of Vulnerable Things

By Holger Reinhardt | October 1, 2013 |

Did you know that October is National Cyber Security Awareness Month in the US? While I usually emphasize the enormous potential of the Internet of Things (IoT), let’s use the occasion to look at the security risks of the Internet of really vulnerable things. Over the last couple of months, a casual observer could have noticed a variety…


API Design Tutorial: The Interaction Model

By pwsadmin | July 16, 2019

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…

Three Common Web Architecture Styles

By pwsadmin | July 16, 2019

When talking to clients about the architectural details of an implementation, one of the first questions I ask is: “What architectural style is appropriate for this Web solution?” It turns out this question stumps most of my audience. Not many system architects and developers think about it. Instead, they implement solutions using whatever components and…

If They Have to Ask, You Didn’t Afford It

By pwsadmin | July 16, 2019

My guess is you are familiar with the phrase “If you have to ask, you can’t afford it”. Well, that’s not what I mean here. Let me show you what I’m actually getting at… If They Have to Ask… Try this: Create a new Web API Get it up and running on some server or other…

Hypermedia Workflow Questions

By pwsadmin | July 16, 2019

Following a talk I gave about hypermedia APIs, I received a question from an Abiel Woldu on how to handle hypermedia support when the same backend operation is called from different workflows. Here’s part of the Abiel’s email: “Say you have an end point for validating address; call it /validateAddress. Now this endpoint is called…

When Good API Design is a Waste of Time

By pwsadmin | July 16, 2019

The idea that good design is essential to building great products and services has become a truism in our industry.  Most of us intuitively understand the idea that expending effort on the design of our code, system architecture and APIs will payoff after implementation.  I’m certainly a big believer in the power of good design…

Dr. Dobb’s: Building Successful Web APIs

By pwsadmin | July 16, 2019

The syntax of APIs matter much less than their discoverability and the ease with which developers can figure out how to use them effectively. In this article, Ronnie Mitra of the API Academy discusses the nuts and bolts of designing developer-friendly APIs.

Books and Guides

A Guide to REST and API Design

By Mike Amundsen | August 7, 2019

API Academy Learn how to use REST to build developer-friendly, sustainable APIs The Representational State Transfer (REST) architectural style is extremely valuable to organizations that want to create APIs as a way to leverage their existing IT resources in new Web and mobile apps. By applying REST design principles to a protocol, such as HTTP,…

5 Pillars of API Management

By Jaime Ryan | August 7, 2019

API Academy Manage security and performance risks created by opening enterprise systems via APIs Traditional enterprise are blurring, as organizations open their on-premise data and application functionality for use in new internal and external applications. APIs form the foundation of this open enterprise, allowing enterprises to reuse their existing information assets across organizational boundaries. To…

Choosing the Right API Management Solution for the Enterprise User

By pwsadmin | August 7, 2019

API Academy Address key functional and operational characteristics of an effective API Management solution This white paper examines the different functional and operational requirements for an enterprise-level API Management solution. In doing so, it gives IT managers, Web managers and enterprise architects key information for selecting an API Management solution. The API is undergoing a…

A How-to Guide to OAuth & API Security

By pwsadmin | August 7, 2019

API Academy Make OAuth implementation simple for your organization OAuth is an emerging Web standard that lets users grant third-party clients restricted access to resources they own. In the past, it was common to ask a user to share username and password information with the client. OAuth authentication is more secure as it allows the…

5 OAuth Essentials for API Access Control

By pwsadmin | August 7, 2019

API Academy Create a framework to address the complex challenges associated with implementing OAuth There are a number of important access-related challenges for API publishers. However, deploying OAuth as an authorization mechanism for enterprise APIs raises challenges around scalability, correct usage and integration. To make matters worse, OAuth is not supported by existing infrastructure and…

Protecting Your APIs Against Attack & Hijack

By pwsadmin | August 7, 2019

API Academy Secure enterprise APIs for mobile, cloud and open Web It is a mistake to think we can secure APIs using the same methods and technologies with which we secured the conventional, browser-centric Web. While it is true that APIs share many of the same threats that plague the Web, APIs are fundamentally different…


Tutorial: The New Enterprise Topology

By pwsadmin | August 6, 2019

Learn how big data and mobile devices are redefining the topology of enterprise IT The three-tier topology popularized by Web applications is changing. Big Data and mobile devices are shifting the borders of enterprise IT and the API has become the new perimeter for organizations, exposing their business and data services for external consumption. This…

Tutorial: Creating a Solid Foundation for Your Web APIs

By pwsadmin | August 6, 2019

Learn how to create a flexible, agile, reliable and secure foundation for HTTP-based APIs This tutorial video from the API Academy identifies four implementation details (component versus connector; representation service; caching layer; security layer) that are highly useful for creating a flexible, agile, reliable and secure foundation for HTTP-based APIs.

Tutorial: The API Interaction Model – An Introduction

By pwsadmin | August 6, 2019

Learn about interaction-based API design The interaction model is a foundational design element for API architects. This tutorial video from the API Academy introduces the concept of interaction-based design and provides guidance on how to design an interaction model for an API.

Tutorial: Use Pagination in Web API Design

By pwsadmin | August 6, 2019

Learn how to use pagination effectively in your Web APIs Pagination, which is very common on the Web, allows API architects to conserve resources, improve response times and optimize the user experience. This tutorial video from the API Academy provides a crash course explaining pagination and outlining how to use it effectively in the design…

Tutorial: Handle Errors on the Web

By pwsadmin | August 6, 2019

Learn about the right and wrong ways for Web applications to handle errors All applications need to report and handle errors. Doing this on the Web requires dealing with both protocol-level and application-level information. This video shows both the “right” and the “wrong” way to handle errors on the Web.

Tutorial: API Documentation Overview

By pwsadmin | August 6, 2019

Learn how to document your API to ensure the best possible results To make sure developers use your API to create apps that add true value to your business, you must provide proper documentation. But where do you start when it comes to creating documentation for an API? This video will give you deeper insight…

Scroll To Top