http

OpenAPI v3.1.0 has a bunch of great changes, solving problems like the subtle differences between JSON Schema objects and OpenAPI Schema…

There are a lot of pros and cons to various approaches to API versioning, but that has been covered in depth before: API Versioning Has No…

With endpoint-based APIs (REST, RESTish, SOAP, RPC, AJAX-ish junk, etc.) you get to choose if you want increased likelihood of network cache…

Representing state is a complex thing. At my last two jobs, it’s been very common for APIs to be treated like “databases over HTTP”. The…

After writing about how GraphQL and REST differ in various regards, and taking a closer look at caching in particular, I wanted to write…

Recently I wrote GraphQL vs REST: Overview, giving a hype-free outline of the differences between REST and GraphQL. One section that would…

A few months back I wrote a comparison between RPC and REST for Smashing Magazine, and now I want to talk about the differences between REST…

Now that we’ve started building a very basic API, we should make sure that the documentation is kept up to date with our progress. Even…

Third video in a pile of LiveCoding.tv videos, shows how to use ActiveModel Serializer to shape the output of your resources. I totally…

The second video in a pile of LiveCoding.tv videos shows how to use your API Blueprint documentation to mock APIs, and a few different ways…

Two years ago I finished the first edition of Build APIs You Won’t Hate, and since then I’ve worked on bigger and better projects, using my…

A new version of Dredd - the API Documentation testing tool from Apiary Inc. - has been released, and it has changed a few things for the…

Recently there has been a lot of buzz about HTTP middleware in PHP. Since PSR-7 was accepted, everyone and their friend Sherly has been…

A question that is asked with increasing regularity in the APIs You Won’t Hate Slack Group is one which has been asked for years, but does…

File uploads are one thing that always feel rather complicated, and working out how to handle this in an API doesn’t make life easier. For…

When planning my talk and book on REST/HTTP API development, I ended up mentioning documentation towards the end, and flippantly said “Oh…

I spotted an article called Just learn Rails (Part 3) HTTP status codes. It started off good, and I liked that it was teaching people to…

Something we’re always taught as developers, usually by tutorials or via the defaults in various ORM tools, is every SQL table needs an auto…

A lot of things in programming are argued to death, but one subject where people almost unanimously agree is that magic numbers can be a…

Two weeks ago I posted RESTful URLs: Actions Need Not Apply which was all about how the only action/verb to appear in the HTTP Request…

I was doing a little consulting for a company while I was out in South Africa and we played the game. You fire SOAP functionality at me, and…

Other than just being easy to forget, these ports are often not open in office environments or internet cafe’s. To get any page on any port…