Taking APIs Further: Deprecation

[philsturgeon]

Surviving Other Peoples APIs covered handling deprecations from the consumer side, but this aims to be a more extensive guide to how API maintainers can handle deprecating entire APIs, endpoints, and potentially even properties by a) updating OpenAPI to cover docs and SDKs, and b) using Sunset and Deprecation headers to alert people via HTTP, then all the softer touch things like emailing people and blogging about it.

https://blog.stoplight.io/deprecating-api-endpoints

https://apisyouwonthate.com/blog/api-evolution-for-rest-http-apis/

https://apisyouwonthate.com/blog/surviving-deprecations-to-resources-and-properties-on-other-apis/

https://blog.treblle.com/best-practices-deprecating-api/