Solving OpenAPI and JSON Schema DivergenceUpdate 2020-02-02: This article has been replaced entirely, as the proposed workaround was written into a now abandoned project Speccy, and…
OpenAPI and JSON Schema Divergence: Part 1This article is going to explain the divergence between OpenAPI and JSON Schema, which I’ve been calling the subset/superset/sideset problem…
Design-first API Specification Workflow MaturesBack in October I wrote Chasing the Perfect API Specification Workflow, which was a huge article about the state of the API specification…
Still Going on REST is the new SOAPThe misunderstandings on REST continue, and I'm happy to explain them all up!
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…