get:
  operationId: getPlatformById
  tags:
    - platforms
  summary: Retourne une plateforme
  parameters:
    - $ref: '#/components/parameters/platformId'
  responses:
    200:
      description: OK
      content:
        application/json:
          schema:
            $ref: '../schemas/Platform.yaml'

put:
  operationId: putPlatformById
  tags:
    - platforms
  summary: Modifie une plateforme
  parameters:
    - $ref: '#/components/parameters/platformId'
  requestBody:
    required: true
    content:
      application/json:
        schema:
          type: object
          properties:
            name:
              type: string
  responses:
    200:
      description: OK
      content:
        application/json:
          schema:
            $ref: '../schemas/Platform.yaml'

delete:
  operationId: deletePlatformById
  tags:
    - platforms
  summary: Supprimer une plateforme
  parameters:
    - $ref: '#/components/parameters/platformId'
  responses:
    204:
      description: Supprimé

components:
  parameters:
    platformId:
      in: path
      name: platformId
      required: true
      description: id de la plateforme
      schema:
        type: integer
