Première des premières versions

Documents/proto/general/openapi.yaml

@@ -20,23 +20,51 @@ paths:
               schema:
                 type: string
                 example: pong
-  /user:
-    put:
-      summary: create a new user
+  /requests:
+    post:
+      summary: Faire une demande
+      tags:
+        - Student
+      responses: 
+        '201':
+          description: Demande envoyée
+  /users:
+    get:
+      summary: Listere les utilisateurs
+      tags:
+        - SI
+      security:
+        - bearer: []
+      responses: 
+        default:
+          description: Success
+  
+  /user: # registration
+    post:
+      summary: Créer un utilisateur
+      tags:
+        - users
+      responses:
+        '200':
+          description: User created
+        '401':
+          $ref: '#/components/responses/UnauthorizedError'
+    patch:
+      summary: modifier ses informations
       tags:
         - users
       security:
         - bearer: []
       responses:
         '200':
-          description: User created
+          description: Informaitions modifiées
         '401':
           $ref: '#/components/responses/UnauthorizedError'
   /user/{mat}:
     get:
       summary: get user's info
       tags:
-        - users
+        - Admin
       responses:
         '200':
           description: User found 
@@ -51,41 +79,160 @@ paths:
         required: true
         schema:
           type: integer
-
-  /cursus/{id}:
-    get:
-      summary: Voir les informations sur un Cursus
+    patch:
+      summary: modifier les informations d'un utilisateur
       tags:
-        - Courses
+        - Admin
+      security:
+        - bearer: []
       responses:
         '200':
-          description: Cursus found
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/Cursus'
+          description: Informaitions modifiées
+        '401':
+          $ref: '#/components/responses/UnauthorizedError'
+
+  /users/requests:
+    get:
+      summary: Lister les requetes d'utilisateurs
+      security:
+        - bearer: []
+      tags:
+        - Secretaria
+        - SI
+      responses:
+        '200':
+          description: Liste les requètes
+
+
+  /user/{mat}/validate/{id}:
+    patch:
+      summary: Valider un utilisateur
+      tags:
+        - Secretaria
+        - SI
+      security:
+        - bearer: []
+      parameters:
+        - name: mat
+          in: path
+          description: matricule de l'utilisateur
+          required: true
+          schema:
+            type: integer
+        - name: id
+          in: path
+          description: Identifiant de la demande
+          required: true
+          schema:
+            type: integer
+        - name: answer
+          in: header
+          description: valide l'utilisateur ou non
+          schema:
+            type: boolean
+      responses:
+        '200':
+          description: Informaitions modifiées
+        '401':
+          $ref: '#/components/responses/UnauthorizedError'
+
   /courses/{id}:
     get:
       summary: Voir les informations sur un cours*
       tags:
         - Courses
       responses:
-    
-    put:
-      summary: Créer un nouveau cours
-      tags:
-        - Courses
-      security: 
-        - bearer: []
-      responses:
-
+        '202':
+          description: success
+    parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: integer
     delete:
       summary: Suprimer un cours
       tags:
         - Courses
+        - Secretaria
       security: 
         - bearer: []
       responses:
+        '202':
+          description: success
+    patch:
+      summary: Changer les options du cours
+      tags:
+        - Secretaria
+        - Courses
+      security:
+        - bearer: []
+      parameters: 
+        - name: professeur
+          in: header
+          required: true
+          schema:
+            type: string
+      responses:
+        '202':
+          description: Bien ouej
+          
+  /cursus:
+    post:
+      summary: Créer un nouveau cours
+      tags:
+        - cursus
+      security: 
+        - bearer: []
+      responses:
+        '202':
+          description: success
+
+            
+  /cursus/{id}:
+    get:
+      summary: Voir les informations sur un cursus
+      tags:
+        - cursus
+      responses:
+        '202':
+          description: success
+    parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: integer
+    delete:
+      summary: Suprimer un cursus
+      tags:
+        - cursus
+      security: 
+        - bearer: []
+      responses:
+        '202':
+          description: success
+    patch:
+      summary: Changer les options du cursus
+      tags:
+        - cursus
+      security:
+        - bearer: []
+      responses:
+        '202':
+          description: Bien ouej
+          
+  /courses:
+    post:
+      summary: Créer un nouveau cours
+      tags:
+        - Courses
+        - Secretaria
+      security: 
+        - bearer: []
+      responses:
+        '202':
+          description: success
 
     
 components:
@@ -124,7 +271,7 @@ components:
           "Address": "Rue de Tounais 42",
           "Country": "BE"},
         "BirthDate": "1941-02-22",
-        "StaffMember": true
+        "StaffMember": true,
         }
     Address:
       type: object