CheckcraftSwagger Editor online: open and validate an OpenAPI specification
Checkcraft is a desktop app for checking APIs and logs without code, with a free edition. Download, no sign-up →
Swagger Editor validates an OpenAPI specification and renders its documentation right in the browser. Here is how to use it and what to do next once the specification is ready.
Where to open it
The official online editor is at editor.swagger.io. Paste the YAML or JSON specification on the left or load a file from the File menu. Documentation appears on the right, and validation errors show above it with a link to the line.
If the specification is private
Client and server generation from the menu sends the specification to an external service. For internal APIs it is safer to run the editor yourself, for example in Docker, and open it on localhost.
docker run -p 8080:8080 swaggerapi/swagger-editorValidation errors
Most often these are YAML indentation, a $ref pointing to a schema that does not exist, a required field missing from properties and an example that does not match its schema. Fix them top to bottom: one indentation error causes a cascade of others.
From specification to checks
A specification describes how the API should behave but does not verify that it still does. Checkcraft can import an OpenAPI specification: it creates requests, and you add rules for the responses. A single response can be compared with a schema from the specification on the JSON Schema validation page.
Repeat this on your own API
Checkcraft is a desktop app that saves API response checks without code and shows what did not match. Start with a sample, then use your own sanitized data. Free runs on Windows and Linux with no time limit.
Download FreeDownload and first runNo sign-up or email needed, the archive is ready in a couple of minutes. See the edition limits.
References
Start with the linked example and compare its result with your own test requirement.