Architektura Pokročilý
API Versioning strategie¶
API VersioningRESTAPI Design 3 min čtení
Jak verzovat REST API bez rozbití klientů. URL, header a query parameter versioning.
Přístupy¶
# URL Path (nejčastější)
GET /api/v1/users/123
GET /api/v2/users/123
# Header
GET /api/users/123
Accept: application/vnd.myapi.v2+json
# Query Parameter
GET /api/users/123?version=2
Breaking vs Non-breaking¶
Breaking: Odebrání pole, změna typu, přidání povinného parametru.
Non-breaking: Přidání nepovinného pole, nový endpoint, nový nepovinný parametr.
Shrnutí¶
Verzujte od začátku. Preferujte additive changes. Starou verzi udržujte po přechodné období.
Potřebujete pomoct s implementací?¶
Náš tým má zkušenosti s návrhem a implementací moderních architektur. Rádi vám pomůžeme.