API versioning strategy क्यों ज़रूरी है

Azure API Management

Fiodar Sazanavets

Senior Software Engineer at Microsoft

API versioning परिचय

Versioning intro

Azure API Management

API versioning के fundamentals

Versioning analogy

  • तब उपयोग करें जब breaking changes उपयोगकर्ताओं को confuse करेंगी

  • नई लाइन बनते समय, यात्री पुरानी लाइन ही इस्तेमाल करते हैं

  • Revisions उसी लाइन पर maintenance जैसे हैं

    • ट्रैक ठीक करना, साइनऐज जोड़ना, सफ़र स्मूद करना

  • APIM में:

    • Versions एक version set में रहती हैं
    • Revisions से आप edit, test कर, एक को current मार्क कर सकते हैं
Azure API Management

Version signposting

  • तीन version signposting strategies supported हैं:
    • Version URL path में घोषित कर सकते हैं
    • Version request header में दे सकते हैं
    • Version URL query string में दे सकते हैं
  • Versioning strategy consistent होनी चाहिए

URL path versioning

Header versioning

Query string versioning

Azure API Management

Version बनाम revision

Version vs revision

Azure API Management

Canary releases

Canary release

  • Outcomes:
    • Feedback अच्छा हो तो revision को current मार्क करें
    • खराब हो तो पिछली revision पर roll back करें

  • जैसे किचन टेस्ट: नई recipe पहले कुछ टेबल्स को सर्व करें

  • APIM में:

    • नई revision बनाएँ और privately test करें
    • सीमित audience को expose करें (pilot product या callers के subset)
    • खास URL से revision number देकर specific revision target करें

  • रेलवे रूपक: टेस्टर्स "maintenance track" पर सफ़र करते हैं, main line प्रभावित नहीं होती

Azure API Management

याद रखने योग्य मुख्य बातें

  • Versions बनाम revisions: कब उपयोग करें
  • Version scheme कॉन्फ़िगर करना
  • बदलावों को आगे/पीछे roll करना

API Management

Azure API Management

अभ्यास करते हैं!

Azure API Management

Preparing Video For Download...