What is API Versioning?
Maintaining multiple versions of an API so existing clients keep working when you make breaking changes.
Why It Matters
API versioning lets you improve your API without breaking applications that depend on the current version.
Real-World Example
Running /api/v1/users and /api/v2/users simultaneously while clients migrate to the new format.
“Understanding terms like API Versioning matters because it helps you have better conversations with developers and make smarter decisions about your software. You do not need to be technical. You just need to know enough to ask the right questions.”
Related Terms
API
A way for different software applications to talk to each other and share data
REST API
A standard way to design APIs that uses simple web addresses and common actions like GET (read) and POST (create)
Semantic Versioning
A version numbering system using MAJOR.MINOR.PATCH that communicates what type of changes were made.
Learn More at buildDay Melbourne
Want to understand these concepts hands-on? Join our one-day workshop and build a real web application from scratch.
Related Terms
API
A way for different software applications to talk to each other and share data
REST API
A standard way to design APIs that uses simple web addresses and common actions like GET (read) and POST (create)
Semantic Versioning
A version numbering system using MAJOR.MINOR.PATCH that communicates what type of changes were made.
GraphQL
An alternative to REST APIs that lets you request exactly the data you need in a single call
Webhook
An automatic notification that one app sends to another when something happens
Endpoint
A specific URL where your API receives requests and sends responses