PHPnews.io

Overview for 'philsturgeon'

API Evolution for REST/HTTP APIs

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 subscri…


API Evolution for REST/HTTP APIs

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 subscri…



Solving OpenAPI and JSON Schema Divergence

Written by Phil Sturgeon / Original link on Apr. 13, 2018

Update 2020-02-02: This article has been replaced entirely, as the proposed workaround was written into a now abandoned project Speccy, and the long-term proposed solution “Alternative Schemas” has been punted to a later version of OpenAPI due to complications with the form it took.Instead of using…



OpenAPI and JSON Schema Divergence: Part 1

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.Update 2020-02-02: JSON Sche…