This guide describes a set of HTTP+JSON API design practices, originally extracted from work on the Heroku Platform API.