Como usar: OpenAPI / Swagger Validator
- Paste your
openapi.yaml/swagger.jsonor open the file. - The version (OpenAPI 3.1, 3.0 or Swagger 2.0) is detected automatically.
- Fix schema errors first — each shows its location in the document.
- Review the additional checks and the endpoint list.
What gets checked
| Check | Details |
|---|---|
| Official schema | The document is validated against the OpenAPI Initiative’s JSON Schema for its version (3.1, 3.0 or Swagger 2.0): required fields, allowed keys, value types |
Broken $ref | Every local reference (#/components/schemas/Pet) must point to something that exists |
Unique operationId | Duplicates break SDK generators and documentation links |
| Path parameters | Every {param} in a path must be declared with in: path and required: true, and vice versa |
| Responses | Each operation needs at least one response |
| Hints | Missing operationId, servers or info.description |
OpenAPI versions
- Swagger 2.0 —
swagger: "2.0",definitions,host/basePath. - OpenAPI 3.0 —
components,servers,requestBody; schemas are a JSON Schema draft-04 subset withnullable. - OpenAPI 3.1 — fully aligned with JSON Schema 2020-12 (
type: [string, "null"]instead ofnullable), addswebhooks.
Limits
External references to other files or URLs are not fetched — bundle multi-file specs first (for example with redocly bundle). Schema validation reports structural problems; style rules such as naming conventions need a linter like Spectral. Validate example payloads against your schemas with the JSON Schema validator, check YAML syntax with the YAML validator, and try the live API with the API tester.
Também pesquisado como: swagger validator, openapi validator, validate openapi, openapi 3.1 validator, swagger 2.0 validator, openapi lint, api spec validator.
Ferramentas que combinam com: OpenAPI / Swagger Validator
- Formatação JSON — Cole o JSON aqui para formatá-lo, compactá-lo ou validá-lo.
- cURL to Code — Paste a curl command — from API docs or “Copy as cURL” in your browser’s DevTools — and get ready-to-run code for six languages, with headers, body and authentication carried over.
- JSONPath Tester — Type a JSONPath query and instantly see what it selects — with the exact path of each match.
- JSON to YAML — Paste JSON and get clean YAML for Kubernetes manifests, Docker Compose, GitHub Actions or any config file.
Perguntas frequentes
Does it support OpenAPI 3.1?
Yes — OpenAPI 3.1.x, 3.0.x and Swagger 2.0 are each validated against their official schema.
Why are there so many errors for one mistake?
The official schemas use alternatives (oneOf), so one wrong value can fail several branches. The tool filters these down to the most specific messages; fix the first one and re-check.
Can it follow $refs to other files?
No, only references within the same document. Bundle multi-file specs into one file first.
Is my API spec uploaded?
No. Validation runs entirely in your browser, so internal API designs stay private.
Posso instalar o OpenAPI / Swagger Validator como um aplicativo da web e usá-lo offline?
Sim. O OpenAPI / Swagger Validator é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.