이 도구가 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.

모두 보기 포매터 및 코드