Overview for 'philsturgeon'
Written by Phil Sturgeon
/ Original link
on Mar. 30, 2018
This article is going to explain the divergence between OpenAPI and JSON Schema, which I've been calling the subset/superset/sideset problem. It'll finish up explaining how we're going to solve it, and ~I'll write part 2 when it is solved~ part two explains the solution. Whenever talking about API…
Written by Phil Sturgeon
/ Original link
on May. 22, 2018
A while back I wrote an article called Understanding RPC, REST and GraphQL which outlined the "what" in how these various approaches differ. This got a few people thinking I was saying REST was drastically superior in all ways, which is a common conclusion when folks hear me describe REST as a laye…
Written by Phil Sturgeon
/ Original link
on May. 21, 2018
A while back I wrote an article called Understanding RPC, REST and GraphQL which outlined the “what” in how these various approaches differ. This got a few people thinking I was saying REST was drastically superior in all ways, which is a common conclusion when folks hear me describe REST as a laye…
Written by Phil Sturgeon
/ Original link
on May. 4, 2018
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 "Right" Way. API evolution is making a comeback these days with GraphQL and gRPC advocates shouting about it. Whatever API paradigm or implementation you subscr…
Written by Phil Sturgeon
/ Original link
on May. 2, 2018
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 “Right” Way. API evolution is making a comeback these days with GraphQL and gRPC advocates shouting about it. Whatever API paradigm or implementation you subscr…
Written by Phil Sturgeon
/ Original link
on Apr. 13, 2018
My previous article explained the divergence between OpenAPI and JSON Schema (a.k.a the subset/superset/sideset problem), and promised solutions. One of those solutions is a tangible thing, which you can install right now! The other is now ready for tool vendors to start considering. To briefly rec…