🔢
Security & Deployment

API Versioning

Evolving APIs Without Breaking Clients
💡 API, versioning, EK, "MULTIPLE, EDITIONS, of, a, BOOK" jaisa, hai — PURANI, EDITION, (v1) ke, READERS, KAAM, KARTE, RAHTE, HAIN, JABKI, EK, NAYI, EDITION, (v2) NAYE, READERS, ke, liye, PUBLISH, ki, jaati, hai.

API, versioning, se, EK, service, apna, API, EVOLVE, kar, sakti, hai, BINA, EXISTING, clients, ko, BREAK, kiye — URL-based, (/v1/orders, /v2/orders), HEADER-based, (Accept: application/vnd.api.v2+json), aur, QUERY-PARAM-based, VERSIONING, STRATEGIES, HAIN.

BACKWARD-COMPATIBLE, changes, (jaise, EK, NAYA, OPTIONAL, field, ADD, karna) VERSIONING, ki, ZAROORAT, NAHI, HOTI — SIRF, BREAKING, changes, (jaise, EK, field, ko, REMOVE/RENAME, karna) NAYE, VERSION, ki, ZAROORAT, DALТE, HAIN.

// URL versioning:
GET /v1/orders/123   // purana client, OLD, response, shape, use, karta, hai
GET /v2/orders/123   // naya, client, NEW, response, shape, use, karta, hai

// Backward-compatible change (koi, versioning, ki, zaroorat, nahi):
// { id, amount } → { id, amount, discountApplied: false }  // naya, optional, field
🔢
API, versioning, EK, "MULTIPLE, EDITIONS, of, a, BOOK" jaisa, hai — PURANI, EDITION, (v1) ke, READERS, KAAM, KARTE, RAHTE, HAIN, JABKI, EK, NAYI, EDITION, (v2) NAYE, READERS, ke, liye, PUBLISH, ki, jaati, hai.
1 / 2
⚡ झट से Recap
  • API versioning = service, evolve, ho, sakti, hai, bina, existing, clients, ko, break, kiye
  • URL-based, header-based, query-param-based — versioning, strategies
  • Breaking, changes, ke, liye, hi, naya, version — backward-compatible, changes, ke, liye, nahi
इस page में (2 subtopics)

Sunset, HTTP, header, (RFC, 8594) se, clients, ko, batayaa, ja, sakta hai, ki, EK, API, version, KAB, DEPRECATED, ho, jaayegi — automated, tools, aur, developers, DONO, ko, PROACTIVELY, MIGRATE, karne, ke, liye, PROMPT, karta hai.

// Response header:
// Sunset: Sat, 31 Dec 2026 23:59:59 GMT

Semantic, versioning, (MAJOR.MINOR.PATCH) APIs, PAR, bhi, APPLY, ki, ja, sakti, hai — MAJOR, version, bump, BREAKING, changes, indicate, karta, hai — clients, MAJOR, version, ke, HISAAB, se, DECIDE, kar, sakte, hain, ki, UPGRADE, ki, ZAROORAT, hai, ya, nahi.