API Design

APIDays London 2016: Balancing Speed and Safety

APIDays London 2016 focused on the impact of APIs in the Banking and Fintech industries. Speeding up IT and business development without sacrificing stability and safety is one of the major challenges faced by many organizations today. The challenge increases with the size of the organization, the requirements for safety, and the rate of change […]

The View from #API360

It was my great pleasure to join our inaugural #api360 event in Washington, DC, Sept 12.  The Newseum was an ideal venue, offering a stunning cityscape view including the Capitol building and, of course, the Canadian Embassy.  The day kicked off with Gray Brooks of 18F giving an insider’s view of the widespread API activities taking place in […]

DFTW – Decoupled for the Win

Decouple your service and avoid fatal dependencies It doesn’t matter if your service is “micro” or “oriented”, if it’s tightly coupled â€“ especially if your service is on the Web – you’re going to be stuck nursing your service (and all it’s consumer apps) through lots of pain every time each little change happens (e.g. addresses, operations, arguments, process-flow). And that’s just needless pain. Needless for you and […]

Louisville, Barcelona, APIs, and Racing

I recently had the privilege of participating in two API-related events: the Code PaLOUsa event in Louisville and APIdays Mediterranea in Barcelona. All within just days of each other. It was a great experience. April in Louisville The Louisville Code PaLOUsa event holds a special place in memory for me. It was there, in 2012, that I first began delivering talks […]

Three Common Web Architecture Styles

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

Hypermedia Workflow Questions

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

API Design 304: API Design for Microservices

Learn some best practices for designing APIs that will function optimally in microservice architectures Microservice architecture is helping an increasing number of organizations to minimize the time required for software application projects and to maximize the reliability of backend systems. In this lesson, we explain why APIs are essential to microservices and provide some best practices […]

When Good API Design is a Waste of Time

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

InfoQ: REST-y Reader

The API Academy’s Mike Amundsen is regularly asked which books he would recommend for those who want to learn more about designing, implementing and maintaining Web APIs. In this article, Mike offers a shortlist of books he discovered as he was learning about APIs â€“ many of which are still among the books he consults most regularly.

Dr. Dobb’s: Building Successful Web APIs

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.