Nicolas Fränkel
Evolving your APIs, a step-by-step approach
#1about 1 minute
The challenge of evolving APIs without breaking changes
Evolving an API is difficult because initial development focuses on domain modeling, not long-term versioning strategies.
#2about 5 minutes
Using an API gateway instead of a reverse proxy
An API gateway is a specialized reverse proxy that handles modern, complex requirements like dynamic configuration and client-specific rate limiting.
#3about 4 minutes
Setting up the initial proxy route with Apache APISIX
The first step is to configure the API gateway to proxy requests to the existing upstream service without any downtime.
#4about 3 minutes
Creating a versioned route with path rewriting
Introduce a versioned path like /v1 and use the API gateway to rewrite the request path before forwarding it to the upstream service.
#5about 1 minute
Redirecting legacy endpoints using an HTTP 301 response
Deprecate the old, unversioned endpoint by configuring the API gateway to return an HTTP 301 permanent redirect to the new versioned URL.
#6about 5 minutes
Implementing rate limiting to encourage user registration
Use a custom Lua plugin to enforce rate limits on unauthenticated users, prompting them to register to get an API key for unlimited access.
#7about 2 minutes
Canary releasing the new API version with traffic splitting
Safely roll out the new API version by configuring the gateway to split a percentage of production traffic between the old and new upstreams.
#8about 2 minutes
Deprecating an old API version using HTTP headers
Formally deprecate the V1 endpoint by adding Deprecation, Link, and Sunset headers to the response, guiding clients to the new V2 endpoint.
#9about 6 minutes
Q&A on API versioning and management strategies
The audience asks questions about rate limiting per token, managing multiple versions, reverting changes, and the definition of API management.
Related jobs
Jobs that call for the skills explored in this talk.
ROSEN Technology and Research Center GmbH
Osnabrück, Germany
Senior
TypeScript
React
+3
envelio
Köln, Germany
Remote
Senior
Python
Software Architecture
Matching moments
05:01 MIN
Evolving an API without versioning using a fallback pattern
Designing gRPC APIs - The things they don't tell you
01:50 MIN
The challenges of building and maintaining APIs
API = Some REST and HTTP, right? RIGHT?!
02:43 MIN
Designing APIs for trust and backward compatibility
API‑First: How Twilio Designs for Developers - Justin Kitagawa (Twilio)
03:57 MIN
Q&A on adopting new web APIs
Explore new web features before everyone else
01:24 MIN
The cyclical nature of API design and development
Awful APIs: A History Lesson in Industry Mistakes and Mishaps
02:09 MIN
A practical guide to deprecating old API versions
API = Some REST and HTTP, right? RIGHT?!
04:07 MIN
Implementing data aggregation and API management
Building high performance and scalable architectures for enterprises
02:52 MIN
Tracing the evolution of APIs from RPC to GraphQL
The Great API Debate: REST, GraphQL, or gRPC?
Featured Partners
Related Videos
28:55Awful APIs: A History Lesson in Industry Mistakes and Mishaps
James Seconde
27:17Designing gRPC APIs - The things they don't tell you
Bastian Eicher
20:29REST in Peace? What does the API protocol of the future look like? Or do we have it already?
Simon Auer
46:48Seven Myths, Three Reasons, One Goal
Stefan Priebsch
58:52Get ready for new features - the legacy challenge
Hans Hosea Schäfer
28:12Scaling: from 0 to 20 million users
Josip Stuhli
29:30Lessons from Our API Past: Evolving to a Resilient API Future
Yousaf Nabi
28:16The Great API Debate: REST, GraphQL, or gRPC?
Alexis Yushin
Related Articles
View all articles
From learning to earning
Jobs that call for the skills explored in this talk.
Code Healers LLC
Hinesville, United States of America
Remote
€40-50K
Intermediate
Senior
PHP
.NET
React
+2
PiNCAMP GmbH
Berlin, Germany
Senior
React
GraphQL
Next.js
&why GmbH
Berlin, Germany
€50-70K
Junior
Intermediate
Senior
React
Next.js
TypeScript
Api Sa
Bussigny, Switzerland
Senior
API
Azure
DevOps
Continuous Delivery
Continuous Integration
+1
Omniciel
Canton d'Aix-en-Provence-2, France
Senior
API
DevOps
Unit Testing
Omniciel
Canton d'Aix-en-Provence-2, France
Remote
€55-60K
PHP
API
C++
+11