OpenAPI Validator

Check OpenAPI and Swagger specifications for structural errors, missing fields, and best-practice warnings.

freeworks offlinenothing uploaded
Input
Output
—

About openapi validator

OpenAPI Validator is one page doing one thing. No account, no settings to sync, no history building up somewhere.

No telemetry, no analytics on what you type, no request that carries the contents anywhere. The browser does the whole job.

You will find it under APIs & HTTP, alongside 25 other tools for the same sort of job.

Reports path count, operation count, and schema statistics.

How to use it

01
Start it
Every control is on the tool itself. Keyboard shortcuts, where there are any, are listed beside it.
02
Watch it run
It updates in the page as you go. Nothing is sent anywhere, so it keeps working with the network off.
03
Close when done
Nothing is stored between visits. Reloading gives you a clean start rather than picking up where you left off.

Examples

Validate Pet Store Spec
Check an OpenAPI 3.0 spec for errors and warnings
Input
{"openapi":"3.0.3","info":{"title":"Pet Store","version":"1.0.0"},"paths":{"/pets":{"get":{"summary":"List pets","responses":{"200":{"description":"OK"}}}}}}
Output
Valid: yes
Version: 3.0.3
Errors: none
Warnings: Missing recommended 'info.description', Missing recommended 'info.contact', Missing 'operationId' in GET /pets, Missing 'servers' array (recommended for OpenAPI 3.x)

STATS
Paths: 1
Operations: 1
Schemas: 0
Parameters: 0

Questions

Does OpenAPI Validator work offline?+

Yes. It is JavaScript running in this tab, so once the page has loaded it needs nothing further from the network. Put the machine in flight mode and it carries on. Nothing you do here is sent anywhere, because there is nowhere for it to go.

Does it remember anything between visits?+

No. Reload the page and it starts from nothing. There is no account, no saved state and no cookie holding your last session. That is a deliberate trade: it cannot lose your data because it never keeps any.

Is it accurate?+

Timing comes from performance.now(), the high resolution clock the browser provides, rather than from setInterval, which drifts by a few milliseconds every tick and compounds over minutes. What can still shift things is the browser throttling a tab in the background, so leave it visible if the timing matters.

Does it make a sound?+

Where a sound makes sense, it is generated with the Web Audio API rather than loaded as a file, so there is nothing to download and nothing to block. Browsers refuse to start audio until you have interacted with the page, which is why the first press is what switches it on.

Can I use OpenAPI Validator on a phone?+

Yes. The controls are sized for touch and the layout collapses to one column on a narrow screen. Bear in mind that a phone locking its screen will suspend the page, and timing stops with it.