संस्करणीकरण

संस्करणीकरण

BazaarLink एकल स्थिर API पथ को उजागर करता है, /v1 - प्रबंधित करने के लिए कोई दिनांक-पिन किए गए संस्करण या संस्करण हेडर नहीं हैं। API क्रमांकित रिलीज़ के बजाय लगातार विकसित होता है।

नॉन-ब्रेकिंग परिवर्तन

ये जहाज बिना किसी पूर्व सूचना के:

• नए समापनबिंदु
• कैटलॉग में नए मॉडल जोड़े गए
• नए वैकल्पिक अनुरोध पैरामीटर
• नए प्रतिक्रिया फ़ील्ड
• वैकल्पिक गुणों के साथ नए स्कीमा
• अतिरिक्त प्रतिक्रिया status/error कोड

ब्रेकिंग परिवर्तन

ये दुर्लभ हैं, और कवर करते हैं:

• किसी समापन बिंदु, पैरामीटर या प्रतिक्रिया फ़ील्ड को हटाना या उसका नाम बदलना
• फ़ील्ड का प्रकार बदलना
• एक वैकल्पिक पैरामीटर बनाना आवश्यक है

जब वे घटित होते हैं, तो संपूर्ण /v1 सतह के बजाय एक विशिष्ट समापन बिंदु पर एक ब्रेकिंग परिवर्तन लागू होता है - कोई एकल संस्करण बम्प नहीं है जो एक ही बार में प्रत्येक एकीकरण को तोड़ सकता है। हमने अभी तक ब्रेकिंग-चेंज टैग के साथ कोई औपचारिक चेंजलॉग प्रकाशित नहीं किया है (नीचे वर्तमान में बने रहना देखें); एकीकरण-महत्वपूर्ण किसी भी चीज़ के लिए, अप्रलेखित व्यवहार पर भरोसा करने से पहले समर्थन के माध्यम से संपर्क करें।

अवमूल्यन नीति

एक नियमित "ब्रेकिंग" घटना जिसकी आपको उम्मीद करनी चाहिए: व्यक्तिगत मॉडल सेवानिवृत्त हो जाते हैं क्योंकि अपस्ट्रीम प्रदाता उन्हें पदावनत कर देते हैं। GET /v1/models के माध्यम से मॉडल की वर्तमान स्थिति के बारे में पूछें।

GET https://api.bazaarlink.ai/v1/models
Authorization: Bearer sk-bl-YOUR_API_KEY

# A model within 30 days of its deprecation date shows in the catalog
# with an "EOL" badge on the Models page. After the effective date it's
# dropped from the catalog and calls return:
# 410 { "error": { "type": "model_not_available", "code": "model_retired" } }

वर्तमान में बने रहें

हमने अभी तक एक समर्पित API चेंजलॉग या RSS फ़ीड प्रकाशित नहीं किया है। अभी के लिए, इस पृष्ठ को सीधे जांचें, GET /v1/models के माध्यम से मॉडल की स्थिति देखें, या यदि आपको किसी महत्वपूर्ण एकीकरण के लिए अग्रिम सूचना की आवश्यकता है तो समर्थन से संपर्क करें।