While working with JSON Hyper-Schema I have discovered a couple of common API patterns that could use a little more explanation.

In this article I’m going to show you common hypermedia patterns and how to describe them with JSON Hyper-Schema.

In this article I build on the foundation of the original JSON Hyper-Schema article with resource representations, arbitrary request bodies, HTTP headers, and HTTP methods.

In this talk I give a brief overview of my latest project, Roads API. This framework attempts to simplify many aspects of the API development process.

JSON Hyper-Schema is close to becoming an official spec, so let’s see what it’s all about.

In this article I lay out my thoughts on encouraging public API consumers to use hypermedia. To do that, I need to walk through three quick questions.

In September I attended REST Fest and API World. Here’s a couple of presentations I enjoyed, and links to my own talks.

At API World I spoke about managing change in APIs. You can see part of the talk here.

At REST Fest Greenville I spoke about how Vimeo's API handles complex video privacy options.

At REST Fest Greenville I spoke about three times that hypermedia made my life easier.

Your API is a long-term promise. I promise that my API actions, and how they behave will work as described in the documentation. This promise is hard to uphold.