स्ट्रिप एपीआई यूआरएल में/v1/के लिए क्या है?

Question

Stripe API documentation for versioning कहता है:

जब हम एपीआई के पीछे की ओर असंगत परिवर्तन कर, हम नए दिनांकित संस्करण जारी। वर्तमान संस्करण 2014-12-08 है।

यह कैसे एक विशेष संस्करण के लिए charge API एक्सेस करने का एक उदाहरण देता:

curl https://api.stripe.com/v1/charges \ 
-u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \ 
-H "Stripe-Version: 2014-12-08 

तो हैडर पैरामीटर कौन-सा संस्करण निर्दिष्ट करता है (इस मामले 2014-12-08 में) है, क्या यूआरएल में \v1\ का उद्देश्य है?

Answer 1

उत्तर देने वाला एक अभियंता हमें यह सोचना चाहता है: मैं एक निश्चित बिंदु पर अनुमान लगा रहा हूं, स्ट्रिप के एपीआई में एक बड़ा बदलाव हो सकता है और सब कुछ कैसे व्यवस्थित किया जा सकता है, इस प्रकार उन्हें नाम बदलने के रूप में इतना बड़ा परिवर्तन करना चाहते हैं वी 2। इस तरह v1 एक प्रमुख संस्करण होगा, और उसके बाद 2014-12-08 जैसे संस्करण मामूली संस्करण होंगे। इस प्रकार v1 अर्थपूर्ण संस्करण का एक रूप है।

हालांकि, वास्तव में क्या हुआ वास्तव में उन्होंने पहली एपीआई जारी की और v1 में बुलाया। तब उन्हें एहसास हुआ कि उन्हें इसे अपडेट करना शुरू करना था और "अच्छी तरह से अगर हम v1 में v2 और फिर v3 में बदलना शुरू करते हैं, हर बार जब हम एक अपडेट जारी करते हैं तो उपयोगकर्ताओं को सही संस्करण कॉल करने के लिए अपने कोड को अपडेट करने की आवश्यकता होती है। इसलिए वे इसके साथ आए वर्जन हेडर जो उन्हें उसी यूआरएल का उपयोग करके एपीआई संस्करणों को गेट करने देता है और यूआरएल में v1 सिर्फ vestigial है।