Evolving your APIs, a pragmatic approach

By Nicolas Frankel

Elevator Pitch

Like any architecture-related REST APIs are easy to get started on, but their lifecycle is hard manage if you don’t plan for it. Here is a pragmatic process to do that.

Description

When you publish your first HTTP API, you’re more focused on short-term issues than planning for the future. However, chances are you’ll be successful, and you’ll “hit the wall”. How do you evolve your API without breaking the contract with your existing users?

In this talk, I’ll first show you some tips and tricks to achieve that: moving your endpoints, deprecating them, monitoring who’s using them, and letting users know about the new endpoints. The talk is demo-based, and I’ll use the Apache APISIX project for it.