Пайдаланушының тегін өзгерту әдісіне арналған қарапайым Swagger жаза аласыз ба?

Төменде пайдаланушының тегін өзгерту үшін қарапайым Swagger (OpenAPI 3.0) API әдісінің мысалы берілген:

openapi: 3.0.0
info:
  title: User API
  version: 1.0.0
paths:
  /users/{userId}/lastname:
    put:
      summary: Пайдаланушының тегін өзгерту
      parameters:
        - in: path
          name: userId
          schema:
            type: integer
          required: true
          description: Пайдаланушының ID
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                lastName:
                  type: string
                  description: Пайдаланушының жаңа тегі
              required:
                - lastName
      responses:
        '200':
          description: Тегі сәтті жаңартылды
          content:
            application/json:
              schema:
                type: object
                properties:
                  userId:
                    type: integer
                  lastName:
                    type: string
        '400':
          description: Қате сұрау
        '404':
          description: Пайдаланушы табылмады