A Response to REST is the new SOAPThis article outlines a list of common misunderstandings about REST, so I thought it would be a nice opportunity to set the record straight on a bunch of them. The article is really just 100% misunderstandings, so lets learn some stuff!
One Month Since OpenAPI v3.0Last month today OpenAPI v3.0 was released, and not only is there a lot of cool stuff, but it unblocks some akward situations with vendor…
A Happy Compromise Between Customization and CacheabilityWith endpoint-based APIs you get to choose if you want increased likelihood of network cache hits, or the ability to slim down the response. The two goals are mutually exclusive, but there is a compromise that can be made.
Chasing the Perfect API Specification WorkflowDocumentation is a nice thing to have, but it is often treated as optional or superfluous, especially in teams where the clients and servers…
Representing State in REST and GraphQLIt's very common for APIs to be treated like "databases over HTTP", with clients expected to infer state from a collection of boolean switches and date fields. Stop this with HATEOAS.
You Might Not Need GraphQLAfter writing about how GraphQL and REST differ in various regards, and taking a closer look at caching in particular, I wanted to write…
GraphQL vs REST: CachingRecently I wrote GraphQL vs REST: Overview, giving a hype-free outline of the differences between REST and GraphQL. One section that would…
GraphQL vs REST: OverviewA 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…
Building APIs with Rails: Handling Errors NicelyIgnoring one session covering basic CRUD and deserialization using ActiveModel::Serializer, we get to a more interesting session: Handling…
Building APIs with Rails: Documentation TestingNow 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…
Building REST APIs with Rails: Basic SerializationThird video in a pile of LiveCoding.tv videos, shows how to use ActiveModel Serializer to shape the output of your resources. I totally…
Mocking APIs with API BlueprintThe 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…