API Academy for All Roles

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.

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

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

InfoQ: A Web API Design Methodology

Designing Web APIs is more than just URLs, HTTP status codes, headers and payloads. The process of design – what is essentially a “look and feel” for your API – is very important and is well-worth the effort. This article briefly outlines a methodology that results in an API design that takes advantage of both […]

InfoQ: Description, Discovery & Profiles – A Primer

Take a look at the key opportunities and challenges in the API description/discovery/profiles space Kicking off InfoQ’s The Next Level in Web APIs series, Mike Amundsen takes a look at key formats and vendors in the API description/discovery/profiles space then identifies the opportunities and challenges in this fast-moving portion of the Web API field.

Tutorial: Handle Errors on the Web

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.

A Hypermedia Hero’s Tale

In this presentation, recorded at APIdays Mediterranea, Mike Amundsen of the API Academy takes the audience on a journey that reminds us all of both the challenges and the wonder of computing in the information age and—in the end—encourages us all to embark on our own hero’s journey.

The Internet of Things and Security – Redux

The recent debacle of the Nissan Leaf triggered memories.  Twenty three months ago, I wrote a blog entitled The Internet of Things – Today.  In that posting, I mused about the rapidly emerging IoT, and some of the cool new things that were beginning to appear, such as Anki Drive and Nest solutions.  I also […]