TP-API/Exo3.yml at main · saviola24/TP-API · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
openapi: 3.0.0
info:
  title: API de gestion de tâches
  version: 1.0.0
  description: API pour gérer des tâches.

servers:
  - url: http://localhost:8000
    description: Serveur de développement

components:
  schemas:
    Task:
      type: object
      properties:
        id:
          type: integer
          description: Identifiant unique de la tâche.
          example: 1
        title:
          type: string
          description: Titre de la tâche.
          example: "Faire les courses"
        completed:
          type: boolean
          description: Statut d'achèvement de la tâche.
          example: false
      required:
        - id
        - title
        - completed
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Message d'erreur.
          example: "Task not found"

paths:
  /tasks:
    get:
      summary: Récupérer toutes les tâches
      operationId: getAllTasks
      responses:
        '200':
          description: Liste de toutes les tâches.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Task'
    post:
      summary: Créer de nouvelles tâches
      operationId: createTasks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Task'
      responses:
        '201':
          description: Liste des tâches nouvellement créées.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Task'
    delete:
      summary: Supprimer une liste de tâches
      operationId: deleteMultipleTasks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: integer
                description: ID de la tâche à supprimer.
      responses:
        '200':
          description: Liste des tâches supprimées.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Task'

  /tasks/{id}:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
        description: ID de la tâche.
    get:
      summary: Récupérer une tâche par ID
      operationId: getTaskById
      responses:
        '200':
          description: Tâche trouvée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Task'
        '404':
          description: Tâche non trouvée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    delete:
      summary: Supprimer une tâche par ID
      operationId: deleteTaskById
      responses:
        '200':
          description: Tâche supprimée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Task'
        '404':
          description: Tâche non trouvée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'