_CORE
AI & Agentic Systems Core Information Systems Cloud & Platform Engineering Data Platform & Integration Security & Compliance QA, Testing & Observability IoT, Automation & Robotics Mobile & Digital Banking & Finance Insurance Public Administration Defense & Security Healthcare Energy & Utilities Telco & Media Manufacturing Logistics & E-commerce Retail & Loyalty
References Technologies Blog Know-how Tools
About Collaboration Careers
CS EN
Let's talk

API Versioning strategie

12. 07. 2024 1 min read intermediate

Architecture Intermediate

API Versioning strategie

API VersioningRESTAPI Design 3 min read

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.

Summary

Verzujte od začátku. Preferujte additive changes. Starou verzi udržujte po přechodné období.

Need Help with Implementation?

Our team has experience designing and implementing modern architectures. We’re happy to help.

Free Consultation

Share:

CORE SYSTEMS tým

Stavíme core systémy a AI agenty, které drží provoz. 15 let zkušeností s enterprise IT.