Your Web API is Not the WWW

One of the most common techniques used by the REST faithful to shut down any questioning of the faith is to appeal to the WWW. This post attempts to establish the fallacy of such an appeal.

An API by Any Other Version

Version 3 of my thoughts on API versioning. Spoiler: It's all just about names.

A Linked Data Overview for Web API Developers

For a while now, I’ve held the belief that the biggest reason people get the whole “REST" thing wrong is because they are looking at Roy Fielding’s doctoral dissertation – the paper that coins the term “REST” - as a prescription for how to design APIs. There are 2 things wrong here that I think explain the current state of the API world when it comes to REST. First, is the idea that the terms and descriptions in the paper can be exclusively applied to the server.

Reading List: Web APIs, REST, Linked Data

In response to my recent post on Swagger and REST, I was asked the following on Twitter: Rather than a Twitter stream of references, I thought I would just consolidate my resource list here. Note that for the most part, this list is limited to books. While I’ve put a few canonical Web documents on here, it’s nearly impossible to go back through and chronicle every blog post and article that has shaped my thinking.

Swagger Ain't REST - is that OK?

If you’ve spent much time with me, you’ve undoubtedly heard me ramble on at length about linked data. And in those conversations, you’ve likely heard me say something to the effect of “linked data is REST”. However, I haven’t really spent much time talking about REST by itself - especially considering the amount of importance heaped on it by proponents of the “API Economy”. I’ve focused my attentions elsewhere primarily because as an architectural style, REST isn’t something that a team can just go and implement.