OpenAPI और Swagger JSON से YAML

$ref पाथ या रिस्पॉन्स कोड तोड़े बिना API स्पेसिफ़िकेशन को JSON और YAML के बीच बदलें।

आउटपुट विकल्प

JSONइनपुट

खाली

YAMLआउटपुट

YAML आउटपुट यहाँ दिखेगा

पूरी तरह आपके ब्राउज़र में चलता है: कुछ भी अपलोड नहीं होता। स्पैम और बॉट्स को रोकने के लिए उचित-उपयोग सीमाएँ लागू हैं (प्रति इनपुट 5 MB, कन्वर्ज़न पर दर-सीमा)।

URL से लोड करें

फ़ाइल सीधे आपके ब्राउज़र द्वारा लाई जाती है, इसलिए सर्वर को क्रॉस-ऑरिजिन अनुरोधों की अनुमति देनी होगी।

कीबोर्ड शॉर्टकट

Ctrl / ⌘ + Enter अभी बदलें
Ctrl / ⌘ + S आउटपुट डाउनलोड करें
Alt + Shift + C आउटपुट कॉपी करें
Alt + Shift + F JSON इनपुट ठीक और फ़ॉर्मेट करें
Alt + Shift + S दिशा बदलें
Alt + Shift + T कोड, ट्री और मैप व्यू के बीच बदलें
Ctrl / ⌘ + Z पूर्ववत करें, फ़ॉर्मेट, ठीक करें और साफ़ करें समेत
Esc फ़ुल स्क्रीन से बाहर निकलें
एडिटर में टेक्स्ट का आकार

$ref पॉइंटर और रिस्पॉन्स कोड मान्य रहते हैं

हाथ से कन्वर्ट किए गए स्पेसिफ़िकेशन दो बातों से टूटते हैं: YAML टिप्पणी शुरू करने वाला #, और पूर्णांक बन जाने वाले स्टेटस कोड। दोनों संभाले जाते हैं।

openapi.json
{
  "paths": {
    "/pets/{id}": {
      "get": {
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Pet"
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          }
        }
      }
    }
  }
}
openapi.yaml
paths:
  /pets/{id}:
    get:
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pet'
        4XX:
          description: Client error

हाथ से लिखा, बिना कोट्स पर स्विच करें और देखें कि $ref null बन जाता है और वाइल्डकार्ड होस्ट पार्स नहीं होता।

परिणाम को लिंट करें

कन्वर्ट करने के बाद लिंटर चलाएँ, ताकि सिर्फ़ सिंटैक्स नहीं, स्पेसिफ़िकेशन भी जाँचा जाए। यहाँ संपादन करते समय हर लोकल $ref जाँचा जाता है।

bash
# Lint the converted spec (OpenAPI 3.x and Swagger 2.0)
npx @redocly/cli lint openapi.yaml

API स्पेसिफ़िकेशन के लिए JSON या YAML?

लिखने के लिए YAML

लंबे विवरण YAML ब्लॉक टेक्स्ट में बेहतर पढ़े जाते हैं, और टिप्पणियों से आप रिव्यू करने वालों के लिए स्पेसिफ़िकेशन पर नोट जोड़ सकते हैं।

टूलिंग के लिए JSON

कोड जनरेटर, गेटवे और SDK अक्सर JSON सबसे तेज़ लोड करते हैं, और कई स्पेसिफ़िकेशन को /openapi.json पर उपलब्ध कराते हैं।

एक ही डॉक्यूमेंट

दोनों फ़ॉर्मेट एक ही API का वर्णन करते हैं। किसी भी दिशा में बेझिझक कन्वर्ट करें; स्पेसिफ़िकेशन का कुछ भी नहीं खोता।

और टूल्स

जहाँ भी JSON और YAML मिलते हैं, उसके लिए कन्वर्टर, वैलिडेटर और चरण-दर-चरण गाइड।

अक्सर पूछे जाने वाले प्रश्न

OpenAPI JSON फ़ाइल को YAML में कैसे बदलें?

openapi.json पेस्ट या अपलोड करें और दाएँ पैन से YAML कॉपी करें, या उसे openapi.yaml के रूप में डाउनलोड करें। संरचना, $ref पॉइंटर, उदाहरण और विवरण ठीक वैसे ही रहते हैं।

क्या यह OpenAPI 3 के साथ Swagger 2.0 के लिए भी काम करता है?

हाँ। कन्वर्टर डॉक्यूमेंट की संरचना पर काम करता है, इसलिए Swagger 2.0, OpenAPI 3.0 और OpenAPI 3.1 स्पेसिफ़िकेशन दोनों दिशाओं में एक ही तरह कन्वर्ट होते हैं।

$ref: '#/components/...' कोट में क्यों है?

YAML में स्पेस के बाद आने वाला # टिप्पणी शुरू करता है। कोट्स के बिना $ref: के बाद की हर चीज़ टिप्पणी मानी जाती और रेफ़रेंस खाली रह जाता। कन्वर्टर इसे अपने-आप कोट करता है।

रिस्पॉन्स कोड '200' के रूप में क्यों लिखे जाते हैं?

OpenAPI में रिस्पॉन्स कोड का स्ट्रिंग कुंजी होना ज़रूरी है। YAML में बिना कोट का 200 एक पूर्णांक है; ज़्यादातर टूल इसे स्वीकार करते हैं, पर सख़्त वैलिडेटर नहीं। कोट करने से स्पेसिफ़िकेशन हर जगह मान्य रहता है।

OpenAPI YAML को वापस JSON में कैसे बदलें?

एडिटर के ऊपर के टॉगल से दिशा को YAML → JSON पर करें, या YAML से JSON कन्वर्टर इस्तेमाल करें। YAML के एंकर विस्तृत कर दिए जाते हैं, क्योंकि JSON में उस तरह के रेफ़रेंस नहीं होते।