Aller au contenu
Réservation de salles (démonstration)
← Tous les fichiers de cette version

openapi.yaml

modifié Son contenu a changé depuis la version précédente (Version 1.0).

openapi: 3.1.0
info:
  title: Réservation de salles
  version: 1.1.0
paths:
  /rooms/{roomId}/bookings:
    post:
      operationId: createBooking
      summary: Réserver une salle
      parameters:
        - name: roomId
          in: path
          required: true
          schema: { type: string }
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: '#/components/schemas/BookingRequest' }
      responses:
        '201': { description: Réservation enregistrée }
        '409': { description: Créneau déjà pris }
  /rooms/{roomId}/bookings/{bookingId}:
    delete:
      operationId: cancelBooking
      summary: Annuler une réservation
      parameters:
        - name: roomId
          in: path
          required: true
          schema: { type: string }
        - name: bookingId
          in: path
          required: true
          schema: { type: string }
      responses:
        '204': { description: Réservation annulée }
        '403': { description: Ce n'est pas votre réservation }
components:
  schemas:
    BookingRequest:
      type: object
      required: [start, end]
      properties:
        start: { type: string, format: date-time }
        end: { type: string, format: date-time }