Swagger Validator Badge
You can validate any OpenAPI specification against the OpenAPI 2.0 Schema as follows:
Of course the
YOUR_URL needs to be addressable by the validator (i.e. won't find anything on localhost). If it validates, you'll get a nice green VALID logo. Failures will give an INVALID logo, and if there are errors parsing the specification or reaching it, an ugly red ERROR logo.
For example, using https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v2.0/json/petstore-expanded.json as a source, we get ...
If your specification fails to validate for some reason, or if there is an error, you can get more information on why by visiting
Since the validator uses a browserless back-end to fetch the contents and schema, it's not subject to the terrible world of CORS.
You can also post a spec up to the service with CURL:
curl -X POST -d @swagger.json -H 'Content-Type:application/json' http://online.swagger.io/validator/debug
In this example,
swagger.json is the swagger definition in JSON format, in the CWD.
You can build and run the validator locally:
mvn package jetty:run
And access the validator like such: