OpenAPI Spec Viewer

๐Ÿ“‹ Input OpenAPI Specification

Paste your OpenAPI/Swagger specification (JSON or YAML), or drag and drop a file.

๐Ÿ“‚ Drag and drop JSON/YAML file here

Or click the button below to select a file

๐Ÿ“– OpenAPI Specification Guide

What is OpenAPI Specification

OpenAPI Specification (OAS, formerly Swagger Specification) is an open standard under the Linux Foundation for describing RESTful API interfaces. It uses JSON or YAML format to define complete information about API endpoint paths, HTTP methods, request parameters, request bodies, response formats, and security authentication, making API documentation machine-readable and automatically processable.

OpenAPI 3.x vs Swagger 2.0

Core Structure

  1. openapi/swagger: Specification version number
  2. info: API metadata (title, description, version, etc.)
  3. servers/host+basePath: API server address
  4. paths: API endpoint paths and method definitions
  5. components/definitions: Reusable schema components
  6. security: Global security requirements
  7. tags: Endpoint grouping tags

Use Cases

๐Ÿ“– FAQ

What is OpenAPI Specification?

OpenAPI Specification (OAS, formerly Swagger Specification) is a standardized format for describing RESTful APIs. It uses JSON or YAML syntax to define API endpoints, request parameters, response formats, authentication methods, and more, making API documentation machine-readable and enabling automatic client code generation.

What is the difference between OpenAPI 3.x and Swagger 2.0?

OpenAPI 3.x is the successor to Swagger 2.0. Key differences: 1) Uses openapi field instead of swagger; 2) Supports oneOf/anyOf/allOf composition schemas; 3) Improved security definitions with components/securitySchemes; 4) Supports callbacks and links; 5) Uses requestBody instead of body parameters.

How to validate an OpenAPI specification file?

This tool automatically detects and parses OpenAPI/Swagger specification files, checks JSON/YAML syntax correctness, verifies required fields (openapi/swagger, info, paths), and highlights missing or malformed sections.

What formats of OpenAPI files are supported?

Both JSON and YAML formats are supported. You can paste content directly, drag and drop files, or import via URL. Supports OpenAPI 3.0.x, 3.1.x, and Swagger 2.0 versions.

Is my data uploaded to a server?

No. All OpenAPI specification parsing and visualization happens locally in your browser. Your API specification content is never sent to any server, ensuring your API design security.

How to view API endpoints with this tool?

Paste your OpenAPI specification content into the input area or drag and drop a file. The tool will automatically parse and display all API endpoints in a tree structure. Click any endpoint to view detailed request parameters, response formats, and example data.