openAPI 文法: array, object, tag, parameters, schemas

1.array

msg:
  type: array
  items:

2.object

msg:
  type: object
  properties:

3.tag & parameters & schemas

tags:
#1.
  - name: "contacts"
    description: "Paths related to handling contacts"
・・・

paths:
  #1. /api/contacts
  #1.1
  #require('./routes/contacts.js');

  #1.1.1
  /api/contacts/generate:
    post:
      description: \#1.1.1 contacts generate
      operationId: contacts_generate
      tags:
        - "contacts"
      parameters:
        - in: "body"
          name: "body"
          required: true
          schema:
            $ref: '#/contacts/schemas/Request_generate'

      responses:
        '200':
          description: generate response
          content:
            application/json:
              schema:
                $ref: '#/contacts/schemas/Responses_generate'
・・・

#------------------------ schemas -------------------------
contacts:
  schemas:
    #1.1.1
    Request_generate:
      type: object
      properties:
        buyer:
          type: string
        seller:
          type: string
        uses:
          type: string
        expire:
          type: string

    Responses_generate:
      required:
      properties:
        type: string