एक API संस्करण पाएँ
API संस्करण 2026-10-affable-towhee
एक API संस्करण को उसकी पूरी history, उसके summary (अंग्रेज़ी में) और उसके spec के साथ लौटाता है। spec.url पर मौजूद दस्तावेज़ इस संस्करण का तभी होता है जब उसे Lingara-Version हेडर को इसकी id पर सेट करके माँगा जाए। spec.sha256 इसके फ़्रीज़ किए गए दस्तावेज़ का हैश है, और संस्करण के विकास में रहने तक null रहता है। अज्ञात id पर 404 मिलता है। किसी टोकन की ज़रूरत नहीं है। जवाब एक घंटे तक कैश किए जा सकते हैं।
स्कोप प्रमाणीकरण आवश्यक नहीं
पैरामीटर
Lingara-Versionheaderstringवैकल्पिक- वह API संस्करण जिसके अंतर्गत इस अनुरोध का उत्तर दिया जाए। इसके बिना, एक्सेस टोकन को वह संस्करण मिलता है जिससे उसका क्लाइंट जुड़ा है, और बिना टोकन वाले अनुरोध को वर्तमान संस्करण मिलता है। विकासाधीन संस्करण तक केवल उसे यहाँ नाम देकर पहुँचा जा सकता है। अज्ञात संस्करण का उत्तर
400और कोडapi_version_unknownहोता है।GET /v1/versionsसंस्करणों की सूची देता है। idpathstringआवश्यक
प्रतिक्रियाएँ
200 API संस्करण
idstringआवश्यकstateVersionStateआवश्यकltsbooleanआवश्यकminted_atstringआवश्यकsunset_atstring | nullआवश्यकsummarystring | nullआवश्यकhistoryarray of VersionHistoryEntryआवश्यकstateVersionStateआवश्यकatstringआवश्यक
specVersionSpecआवश्यकurlstringआवश्यकsha256string | nullआवश्यक
asyncapiVersionSpecआवश्यकurlstringआवश्यकsha256string | nullआवश्यक
त्रुटियाँ
410application/json- जिस API संस्करण के अंतर्गत इस अनुरोध का उत्तर दिया जाता है, वह बंद कर दिया गया है।
Lingara-Versionमें कोई समर्थित संस्करण भेजें, या क्लाइंट को किसी दूसरे संस्करण से जोड़ें। 4XXapplication/json- अनुरोध अस्वीकार कर दिया गया।
codeकारण बताता है, औरerrorउसे शब्दों में बताता है। 503application/json · text/plain- सेवा अस्थायी रूप से अनुपलब्ध है;
Retry-Afterमें दिए गए सेकंड के बाद पुनः प्रयास करें। रखरखाव के दौरान बॉडी त्रुटि लिफ़ाफ़े के बजाय सादा टेक्स्ट होती है। 5XXapplication/json- अनुरोध अस्वीकार कर दिया गया।
codeकारण बताता है, औरerrorउसे शब्दों में बताता है।
codestringआवश्यकअनुरोध क्यों अस्वीकार किया गया, एक स्थिर कोड के रूप में जिसके आधार पर आप शाखा बना सकते हैं: उदाहरण के लिए
insufficient_scope(403),rate_limited(429) और, मीटर्ड क्लाइंट के लिए,spend_cap_reached(402) औरmetered_billing_inactive(402)।errorstringआवश्यक
उदाहरण
यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।