स्वैगर संस्करण 2.0 में किसी भी के बराबर क्या है, कृपया मुझे बताएं कि मेरी जेसन फ़ाइल कैसे अपडेट करें क्योंकि मैं अपने दस्तावेज़ को स्वैगर 1.0 से 2.0 में अपग्रेड करना चाहता हूं।स्वैगर 2.0 कोई भी
आपकी सहायता के लिए धन्यवाद।
मुझे नहीं लगता कि एक है और यह एक बड़ी कमी की तरह लगता है। यह निश्चित रूप से the Schema Object portion of the specification में उल्लेख नहीं किया गया है। वे बाहर वहाँ तत्वों है कि JSON स्कीमा और anyOf से अपनाया गया है फोन उन के बीच में नहीं है:
निम्नलिखित गुण JSON स्कीमा परिभाषा से सीधे लिया जाता है और का पालन कर रहे हैं एक ही विनिर्देशों:
- $ रेफरी - एक JSON संदर्भ
- प्रारूप (अधिक जानकारी के लिए देखें डेटा प्रकार प्रारूप)
- शीर्षक के रूप में
- वर्णन (GFM वाक्य रचना रिच टेक्स्ट representat के लिए इस्तेमाल किया जा सकता आयन)
- डिफ़ॉल्ट (JSON स्कीमा के विपरीत, मूल्य स्कीमा वस्तु के लिए परिभाषित प्रकार)
- multipleOf
- अधिकतम
- exclusiveMaximum
- न्यूनतम
- exclusiveMinimum
- maxLength
के अनुरूप होना चाहिए- मिनी लम्बाई
- पैटर्न
- maxItems
- minItems
- uniqueItems
- maxProperties
- minProperties
- आवश्यक
- enum
- प्रकार
निम्नलिखित गुण JSON स्कीमा परिभाषा लेकिन उनकी परिभाषा से लिया जाता है स्वैगर विशिष्टता में समायोजित किया गया था। उनकी परिभाषा जेएसओएन स्कीमा की तरह ही है, केवल मूल परिभाषा जेएसओएन स्कीमा परिभाषा का संदर्भ देती है, इसके बजाय स्कीमा ऑब्जेक्ट परिभाषा का उपयोग किया जाता है।
- आइटम
- allof
- गुण
- additionalProperties
मुझे लगता है कि निकटतम बात discriminator क्षेत्र है, लेकिन इसका मतलब है कि आप अपने उत्पादन की संरचना करने के समायोजित करने के लिए मिल गया है अकड़।
anyOf और oneOf अब OpenAPI Specification 3.0 (26 जुलाई, 2017 को जारी) में समर्थित हैं।