APIs You Won't Hate

Phil, Mike, and Matt get together to talk about how to safely sunset and deprecate your API so you dont anger your team or outside API consumers.

Show Notes

Phil, Mike, and Matt get together for a discussion about how to safely sunset an API endpoint with the end goal being deprecation. We take a look at why its important to be overly communicative about it, what an appropriate length of time is from announcement to deprecation and how you can do it in a way that doesn't make your team or external consumers angry. We talk about the HTTP Sunset Header and the potential HTTP Deprecation Header and how those can make the process of knowing when APIs are being deprecated a lot smoother. We also looked at a few popular JS libraries and discuss how they deprecated themselves.

Show Notes
Request.js deprecation notice
Moment.js deprecation notice
IEFT HTTP Sunset Header Field RFC
IEFT HTTP Deprecation Header Draft
Facebook botching a feature deprecation

Sponsor
Interested in sponsoring this podcast to get the word out about your API product to our listeners? Drop us a line at @apisyouwonthate on twitter and lets get it set up!

Creators & Guests

Host
Mike Bifulco
Cofounder and host of APIs You Won't Hate. Blogs at https://mikebifulco.com Into 🚴‍♀️, espresso ☕, looking after 🌍. ex @Stripe @Google @Microsoft

What is APIs You Won't Hate?

A no-nonsense (well, some-nonsense) podcast about API design & development, new features in the world of HTTP, service-orientated architecture, microservices, and probably bikes.