Documents/proto/general/openapi.yaml

@@ -10,15 +10,6 @@ servers:
   - url: https://clyde.herisson.ovh/api
     description: default api point for clyde's service
 
-tags:
-  - name: default
-  - name: General
-    description: General endpoints 
-  - name: Ext (scientific articles)
-    description: Scientifics articles extension's endpoints
-  - name: Ext (Schedule)
-    description: Schedule extension's endpoints
-
 paths:
   /ping:
     get:
@@ -44,7 +35,8 @@ paths:
           name: type
           required: false 
           schema:
-            $ref: '#components/schemas/Roles'
+            type: string
+            enum: [teacher, student, secretary]
       responses: 
         '200':
           description: OK
@@ -97,8 +89,6 @@ paths:
                 BirthDate:
                   type: string
                   description: Follow the iso 8601 ("YYYY-MM-DD")
-                Role:
-                  $ref: "#/components/schemas/Roles"
               example:
                 {
                 "LastName": "Doe" ,
@@ -108,7 +98,6 @@ paths:
                   "Address": "Rue de Tournais 42",
                   "Country": "BE"},
                 "BirthDate": "1941-02-22",
-                "Role": "student"
                 }
       responses:
         '201':
@@ -255,8 +244,7 @@ paths:
                 faculty:
                   type: string
                 teachers:
-                  type: integer
+                  $ref: '#/components/schemas/User'
-                  description: Teacher's identifier
                 assistants:
                   type: array
                   items:
@@ -307,6 +295,8 @@ paths:
           description: Cursus created 
         '401':
           $ref: '#/components/responses/UnauthorizedError'
+          
+          
   /cursus/{id}:
     get:
       summary: See Cursus's informations 
@@ -922,6 +912,7 @@ paths:
                   items:
                     $ref: "#/components/schemas/DisplayArticle"
 
+
 components:
   securitySchemes:
     bearer:
@@ -946,8 +937,6 @@ components:
         birthDate:
           type: string
           description: Follow the iso 8601 ("YYYY-MM-DD")
-        role:
-          $ref: '#/components/schemas/Roles'
       example:
         {
         "regNo": 42,
@@ -958,7 +947,7 @@ components:
           "address": "Rue de Tournais 42",
           "country": "BE"},
         "birthDate": "1941-02-22",
-        "role": "student"
+        "staffMember": true,
         }
     Address:
       type: object
@@ -1017,9 +1006,6 @@ components:
         "id": 42,
         "courses": ['Math', 'Info']
         }
-    Roles:
-     type: string
-      enum: [teacher, student, secretary]
 
     RegRequest:
       type : object
@@ -1232,8 +1218,9 @@ components:
         }
 
   responses:
-    UnauthorizedError:
+      UnauthorizedError:
-      description: Unauthorized access or missing bearer 
+        description: Unauthorized access or missing bearer 
+