The object model for OpenAPI specification documents.
- This package knows how to marshal and unmarshal Swagger API specifications into a golang object model
- It knows how to resolve $ref and expand them to make a single root document
- This package is at the core of the go-openapi suite of packages and code generator
- There is a spec loading package to fetch specs as JSON or YAML from local or remote locations
- There is a spec validation package built on top of it
- There is a spec analysis package built on top of it, to analyze, flatten, fix and merge spec documents
No. This package currently only supports OpenAPI 2.0 (aka Swagger 2.0). There is no plan to make it evolve toward supporting OpenAPI 3.x. This discussion thread relates the full story.
An early attempt to support Swagger 3 may be found at: https://github.com/go-openapi/spec3
Not directly. The exposed types know only how to unmarshal from JSON.
In order to load a YAML document as a Swagger spec, you need to use the loaders provided by github.com/go-openapi/loads
Take a look at the example there: https://pkg.go.dev/github.com/go-openapi/loads#example-Spec
Validation is provided by the validate package
ID
field for Schema
which is not part of the swagger spec?We found jsonschema compatibility more important: since
id
in jsonschema influences how$ref
are resolved. Thisid
does not conflict with any property namedid
.