Interview kitsBlog

Your dream job? Lets Git IT.
Interactive technical interview preparation platform designed for modern developers.

XGitHub

Platform

  • Categories

Resources

  • Blog
  • About the app
  • FAQ
  • Feedback

Legal

  • Privacy Policy
  • Terms of Service

© 2026 LetsGit.IT. All rights reserved.

LetsGit.IT/Categories/Architecture
Architecturehard

API versioning — when do you version and what are two common strategies?

Tags
#api-versioning#backward-compatibility#rest
Back to categoryPractice quiz

Answer

Version when you introduce breaking changes you can’t make backward compatible. Common strategies: version in the URL (`/v2/...`) or via headers/content negotiation. Prefer backward-compatible changes when possible (add optional fields).

Advanced answer

Deep dive

Expanding on the short answer — what usually matters in practice:

  • Context (tags): api-versioning, backward-compatibility, rest
  • Scaling: what scales horizontally vs vertically, where bottlenecks appear.
  • Reliability: retries/circuit breakers/idempotency, observability (logs/metrics/traces).
  • Evolution: keep changes cheap (boundaries, contracts, tests).
  • Explain the "why", not just the "what" (intuition + consequences).
  • Trade-offs: what you gain/lose (time, memory, complexity, risk).
  • Edge cases: empty inputs, large inputs, invalid inputs, concurrency.

Examples

A tiny example (an explanation template):

// Example: discuss trade-offs for "api-versioning-—-when-do-you-version-and-what-ar"
function explain() {
  // Start from the core idea:
  // Version when you introduce breaking changes you can’t make backward compatible. Common str
}

Common pitfalls

  • Too generic: no concrete trade-offs or examples.
  • Mixing average-case and worst-case (e.g., complexity).
  • Ignoring constraints: memory, concurrency, network/disk costs.

Interview follow-ups

  • When would you choose an alternative and why?
  • What production issues show up and how do you diagnose them?
  • How would you test edge cases?

Related questions

Architecture
Event schema evolution — how do you avoid breaking consumers?
#events#schema-evolution#backward-compatibility
Architecture
REST vs GraphQL?
#api#rest#graphql
Spring
`@RestController` vs `@Controller`: what’s the difference?
#spring
#mvc
#controller
Microservices
REST vs gRPC for service-to-service calls: what are the key trade-offs?
#microservices#grpc#rest
Spring
`@RequestParam` vs `@PathVariable` — when do you use which?
#spring-mvc#requestparam#pathvariable
Microservices
How do you avoid breaking changes between services (API/contracts)?
#contracts#versioning#backward-compatibility