{"repo":"swagger-api/validator-badge","free":true,"listed":false,"github":"https://github.com/swagger-api/validator-badge","clone":"git clone https://github.com/swagger-api/validator-badge.git","description":"Validate your Swagger JSON/YAML today!","language":"Java","stars":227,"topics":["swagger","validator-badge","swagger-api","rest","restful-api","openapi-specification","openapi3","open-source","swagger-oss"],"license":"Apache-2.0","category":"deployment-docker-iac","readme_excerpt":"Swagger Validator Badge This project shows a \"valid swagger\" badge on your site, supporting Swagger/OpenAPI 2.0 and OpenAPI 3.x specifications. There is an online version hosted on http://validator.swagger.io. Using Docker You can also pull a docker image of the validator directly from DockerHub, e.g.: Since version 2.0.2 local and non http/https urls are rejected by default, along with redirects; this is controllable with docker env variables / java system properties: In non docker environments, system properties rejectLocal and rejectRedirect can be used. Web UI is reachable at http://localhost:8080/index.html and OpenAPI spec at http://localhost:8080/validator/openapi.json You can validate OpenAPI specifications version 2.0 (Swagger), 3.0 and 3.1. Swagger Parser is used for semantic validation. Depending on jsonSchemaValidation query parameter value also JSON Schema validation can be executed (default to true ) Additional parameters allow to customize parsing and validation mode. 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 the","default_branch":null,"files":null,"tree":[],"storefront":"/r/swagger-api","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/swagger-api/validator-badge/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}