OpenAPI Validator
OpenAPI 3.0 Minimum Required Structure
openapi: "3.0.3" # Required: version string
info: # Required
title: "My API" # Required
version: "1.0.0" # Required
paths: # Required (can be empty {})
/users:
get:
summary: "Get all users"
responses: # Required in every operation
"200":
description: "OK" # Required in every response
Common Validation Errors
| Error | Fix |
|---|---|
| Missing 'openapi' field | Add openapi: "3.0.3" at top level |
| Missing 'info.version' | Add version string to info object |
| Missing 'responses' | Every operation needs at least one response |
| Missing 'description' in response | Add description: "..." to each status code |
| Invalid HTTP method | Use: get/post/put/patch/delete/head/options |