OpenAPI Specification Schemas: Difference between revisions
Jump to navigation
Jump to search
Line 4: | Line 4: | ||
* [[OpenAPI_Specification#schemas|OpenAPI Specification]] | * [[OpenAPI_Specification#schemas|OpenAPI Specification]] | ||
=Overview= | =Overview= | ||
The <code>/components/schemas</code> section of the OpenAPI specification defines reusable objects a client or server code generator creates programming language types for. | The <code>/components/schemas</code> section of the OpenAPI specification defines reusable objects a client or server code generator creates programming language types for. This article is annotated with details related to how <code[[Oapi-codegen#Overview|oapi-codegen]]</code> generates Go code. | ||
=Example= | =Example= | ||
<syntaxhighlight lang='yaml'> | <syntaxhighlight lang='yaml'> |
Revision as of 01:31, 26 January 2024
External
Internal
Overview
The /components/schemas
section of the OpenAPI specification defines reusable objects a client or server code generator creates programming language types for. This article is annotated with details related to how <codeoapi-codegen generates Go code.
Example
components:
schemas:
Pet:
allOf:
- $ref: '#/components/schemas/NewPet'
- type: object
required:
- id
properties:
id:
type: integer
format: int64
NewPet:
type: object
required:
- name
properties:
name:
type: string
tag:
type: string
Error:
type: object
required:
- code
- message
properties:
code:
type: integer
format: int32
message:
type: string