API Versioning

Problem

Thousands of clients use: GET /customers You need to change the contract. Updating every consumer simultaneously is impossible.

Solution — API Versioning

Allow old and new contracts to coexist during evolution. /v1/customers /v2/customers
Core idea: versioning lets APIs evolve without requiring every consumer to change at once.