OpenAPI / Swagger Viewer
Upload or paste an API spec and explore every endpoint, parameter, schema and auth requirement — without leaving your browser.
Drop in any OpenAPI 3.x or Swagger 2.0 document (JSON or YAML) and the viewer maps the whole API:
operations grouped by tag with their parameters, request bodies and response codes, the authentication
each operation demands, every schema resolved out of $ref chains with generated sample values,
and copy-ready cURL examples you can run straight from the terminal.
1 · Load a spec
2 · Overview
3 · Authentication
4 · Endpoints
5 · Schemas
Every $ref is resolved inline, so you see the real shape of each type. Click a schema to inspect it.
—
—
6 · Export
Endpoint list (Markdown)
—
OpenAPI vs Swagger — and where to find a spec
The two names get mixed up constantly, so here is the short version:
- Swagger 2.0 (2014–2016) was the first widely-used REST API description format, driven by the Swagger UI project. Specs start with
"swagger": "2.0", carry a singlehost/basePath/schemestriple, and keep types indefinitions. - OpenAPI 3.x is the successor, now maintained by the OpenAPI Initiative (a Linux Foundation project). Specs start with
"openapi": "3.0"or"3.1", support multipleserverswith URL variables, move types tocomponents.schemas, and describe request bodies properly viarequestBody(which 2.0 could only fake with abodyparameter). OpenAPI 3.1 additionally aligns with JSON Schema 2020-12. - Both describe the same thing — a machine-readable contract of endpoints, parameters, schemas and auth — so this viewer handles either. If a tool says “Swagger spec”, it usually means 2.0; “OpenAPI spec” means 3.x.
Where do specs come from?
- FastAPI exposes one automatically at
/openapi.json; many Spring and Express services ship/swagger.jsonor/v3/api-docs. Check the API docs page first — a link to the raw document is usually one click away. - Postman, Insomnia and similar clients can export an entire collection as an OpenAPI 3.x file from their export menu.
- For your own projects, code generators (swagger-codegen / openapi-generator) produce a spec from annotations, or you maintain the YAML by hand — contract-first development means the spec is written before the endpoints are.
Once you have inspected an endpoint here, the API Request Builder helps you assemble and test the actual request, and the JSON Formatter & Validator is handy for tidying the documents you paste in.
Suggested
Luke Keam | techgeek.biz