OpenAPI v3.1 Specification

The implementation of OpenAPI v3.1 Specification for Go using generics.

Supported Go versions:

• v1.23
• v1.22
• v1.21

Versions:

• v0 - Deprecated. The initial version with the full implementation of the v3.1 Specification using generics. See v0 branch.
• v1 - The current version with the in-place validation of the specification.
  • The minimal version of Go is v1.21.
  • Everything have been moved to root folder. So, the import path is github.com/sv-tools/openapi.
  • Added Validator struct for validation of the specification and the data.
    • Validator.ValidateSpec() method validates the specification.
    • Validator.ValidateData() method validates the data.
    • Validator.ValidateDataAsJSON() method validates the data by converting it into map[string]any type first using json.Marshal and json.Unmarshal. WARNING: the function is slow due to double conversion.
  • Use OpenAPI v3.1.1 by default.

Features

• The official v3.0 and v3.1 examples are tested. In most cases v3.0 specification can be converted to v3.1 by changing the version's parameter only.

  @@ -1,4 +1,4 @@
  -openapi: "3.0.0"
  +openapi: "3.1.0"

NOTE: The descriptions of most structures and their fields are taken from the official documentations.

Links

• OpenAPI Specification: https://github.com/OAI/OpenAPI-Specification and https://spec.openapis.org/oas/v3.1.0
• JSON Schema: https://json-schema.org/understanding-json-schema/index.html and https://json-schema.org/draft/2020-12/json-schema-core.html
• The list of most popular alternatives: https://tools.openapis.org

License

MIT licensed. See the bundled LICENSE file for more details.