OpenAPI Specification Schemas

External

• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#schemaObject
• https://tools.ietf.org/html/draft-bhutton-json-schema-00
• https://tools.ietf.org/html/draft-bhutton-json-schema-validation-00

Internal

• OpenAPI Specification

Overview

The /components/schemas section of the OpenAPI specification defines reusable types that are used as input and output data types. These types can represent objects, but also primitives and arrays. The specification is based on JSON Schema Specification Draft 2020-12. A client or server code generator creates programming language types from these schemas. This article is annotated with details related to how oapi-codegen generates Go code.

Schema

SchemaName
  type:
  required:
  properties:
  format:
  description:
  discriminator:
  externalDocs: