Comment utiliser : 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.
Aussi recherché comme : swagger validator, openapi validator, validate openapi, openapi 3.1 validator, swagger 2.0 validator, openapi lint, api spec validator.
Outils complémentaires : OpenAPI / Swagger Validator
- Formateur JSON — Collez votre code JSON pour le formater, le compresser ou le valider.
- 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.
Questions fréquentes
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.
Puis-je installer OpenAPI / Swagger Validator en tant qu’application web et l’utiliser hors ligne ?
Oui. OpenAPI / Swagger Validator est une application web installable (PWA) : elle s’installe depuis votre navigateur, sans passer par une boutique d’applications. Cliquez sur « Installer l’application » en haut de cette page dans Chrome ou Edge (Windows, macOS, Linux, ChromeOS) ; sur Android, utilisez « Partager » → « Ajouter à l’écran d’accueil » sur iPhone et iPad ; ou « Fichier » → « Ajouter au Dock » dans Safari 17+ sur Mac. L’application s’ouvre alors dans sa propre fenêtre avec sa propre icône, et comme elle s’exécute entièrement dans votre navigateur, elle continue de fonctionner hors ligne. Firefox sur ordinateur de bureau ne permet pas d’installer d’applications web. Comment fonctionne l’installation.