هل تدعم هذه الأداة OpenAPI 3.1؟

نعم. إنها تدعم تعريفات OpenAPI 3.1، 3.0، و Swagger 2.0. تقوم الأداة بتحويل البنية الأساسية دون تعديل إصدار المواصفات.

هل ستبقى وثائق API الخاصة بي خاصة؟

نعم. يحدث التحويل بالكامل في متصفحك باستخدام JavaScript. لا يتم إرسال أي بيانات وثائق إلى خوادمنا أو تخزينها خارجيًا.

ماذا يحدث لتعليقات YAML أثناء التحويل؟

لا يدعم JSON التعليقات، لذلك ستتم إزالة أي تعليقات في مصدر YAML الخاص بك عند التحويل إلى JSON. يتم الاحتفاظ بها إذا كنت تقوم ببساطة بتنسيق YAML.

هل يتم التحقق من صحة المخرجات مقابل مخطط OpenAPI؟

تتحقق الأداة من صحة بناء جملة `YAML` و `JSON` أثناء عملية التحويل. للحصول على تحقق كامل على مستوى المخطط، نوصي باستخدام مدقق OpenAPI مخصص.

المنسقات والكود

OpenAPI 3.1 YAML ⇄ JSON

Convert OpenAPI specs between YAML and JSON.

Runs in your browser

OpenAPI YAML · source

lines: 42chars: 924size: 924 B

JSON · result

{
  "openapi": "3.0.3",
  "info": {
    "title": "AnytimeConvert API",
    "version": "1.0.0"
  },
  "paths": {
    "/tools": {
      "get": {
        "summary": "List all tools",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Tool"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/tools/{slug}": {
      "get": {
        "summary": "Get a tool by slug",
        "parameters": [
          {
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Tool"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Tool": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "category"
        ]
      }
    }
  }
}

lines: 79chars: 1576size: 1.5 KB

live

ملاحظة المحرر

Understanding · Same spec, two file formats — pick by audience.

هذا الفصل المعمّق متاح حاليًا باللغة الإنجليزية فقط. أداة التحويل أعلاه تعمل بلغتك؛ أما المقال التفصيلي الطويل فلم تتم ترجمته بعد.

الأسئلة المتكررة

Quick answers.

›Does this tool support OpenAPI 3.1?

Yes. It supports OpenAPI 3.1, 3.0, and Swagger 2.0 definitions. The tool converts the underlying structure without altering the specification version.

›Will my API documentation be kept private?

Yes. The conversion happens entirely in your browser using JavaScript. No document data is sent to our servers or stored externally.

›What happens to YAML comments during conversion?

JSON does not support comments, so any comments in your YAML source will be stripped when converting to JSON. They are preserved if you are simply formatting YAML.

›Is the output validated against the OpenAPI schema?

The tool checks for valid `YAML` and `JSON` syntax during the conversion process. For full schema-level validation, we recommend using a dedicated OpenAPI linter.

يبحث الأشخاص أيضًا عن

أدوات ذات صلة

More in this room.

شاهد الكل في المنسقات والكود