For Enterprise Architects

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.

Three Keys to Design-Time Governance

Three Keys to Design-Time Governance This is my ring of keys – just three of them: work, home, car. I’ve been focusing, over the last couple years, on reducing, cutting back, lightening my load etc. and the keys are one of my more obvious examples of success. I’ve also been trying to lighten my load cognitively â€“ to reduce the […]

How-to: HTTP Caching for RESTful & Hypermedia APIs

Learn how to implement HTTP caching properly in your APIs Cache headers have been an essential part of the HTTP specification from the very beginning. They have played a crucial role in scaling the Web to the enormous size that it has today. Or at least, that statement is true when we talk about the […]

API Strategy 301: API-as-a-Product

Learn how positioning your APIs as products can contribute to success across all aspects of an API program In API Strategy Lesson 203: Building Business Value with a Framework for API Success, we outline key areas of focus essential to designing and maintaining an effective API program. In this lesson, we explain how positioning your APIs as […]

The Next Level in Web APIs

A new series of articles explores API description, discovery and profiles I’m very proud to announce that InfoQ has just launched a new series that I helped edit. The series, called Description, Discovery & Profiles: The Next Level in Web APIs, features a collection of excellent contributing authors including API Academy/CA’s own Ronnie Mitra, Mike Stowe from Mulesoft, Kin Lane of API Evangelist […]