Documents/proto/general/openapi.yaml

@@ -1,9 +1,7 @@
 openapi: 3.0.0
 info:
   title: ClydeAPI
-  description:
+  description: Clyde's api
-    This is the Clyde's api documentation. <br/>
-    Each endpoints are organised by endpoints **AND** by extensions making it easier to navigate.
   version: 0.0.1
 
 servers:
@@ -26,7 +24,6 @@ paths:
     get:
       summary: list all users 
       tags:
-        - General
         - SI
       security:
         - bearer: []
@@ -53,17 +50,7 @@ paths:
     get:
       summary: get informations about yourself 
       tags:
-        - General
         - Users
-      security:
-        - bearer: []
-      parameters:
-        - in: query
-          name: type
-          required: false 
-          schema:
-            type: string
-            enum: [teacher, student, secretary]
       responses:
         '200':
           description: Ok
@@ -71,12 +58,9 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/User"
-        '401':
-          $ref: '#/components/responses/UnauthorizedError'
     post:
       summary: Create user
       tags:
-        - General
         - Users
       requestBody:
         required: true
@@ -114,7 +98,6 @@ paths:
     patch:
       summary: Change informations about yourself 
       tags:
-        - General
         - Users
       security:
         - bearer: []
@@ -140,7 +123,6 @@ paths:
     get:
       summary: Get user's informations 
       tags:
-        - General
         - Admin
       responses:
         '200':
@@ -152,7 +134,6 @@ paths:
     patch:
       summary: Alter user's informations 
       tags:
-        - General
         - Admin
       security:
         - bearer: []
@@ -171,7 +152,6 @@ paths:
     post:
       summary: Create new course 
       tags:
-        - General
         - Courses
         - Secretariat
       security: 
@@ -198,7 +178,6 @@ paths:
     get:
       summary: see courses informations 
       tags:
-        - General
         - Courses
       responses:
         '200':
@@ -216,7 +195,6 @@ paths:
     delete:
       summary: delete a course 
       tags:
-        - General
         - Courses
         - Secretariat
       security: 
@@ -229,7 +207,6 @@ paths:
     patch:
       summary: Change course options 
       tags:
-        - General
         - Secretariat
         - Courses
       security:
@@ -272,7 +249,6 @@ paths:
     post:
       summary: Create a cursus
       tags:
-        - General
         - cursus
       security: 
         - bearer: []
@@ -304,7 +280,6 @@ paths:
     get:
       summary: See Cursus's informations 
       tags:
-        - General
         - cursus
       responses:
         '200':
@@ -322,7 +297,6 @@ paths:
     delete:
       summary: Delete cursus
       tags:
-        - General
         - cursus
       security: 
         - bearer: []
@@ -334,7 +308,6 @@ paths:
     patch:
       summary: Modify cursus 
       tags:
-        - General
         - cursus
       security:
         - bearer: []
@@ -632,7 +605,7 @@ components:
         "firstName": "John",
         "email": "John.Doe@example.com",
         "address": {
-          "address": "Rue de Tournais 42",
+          "address": "Rue de Tounais 42",
           "country": "BE"},
         "birthDate": "1941-02-22",
         "staffMember": true,
@@ -647,7 +620,7 @@ components:
           description: Follow the ISO-3166-1 alpha-2 standard.
       example:
         {
-          "address": "Rue de Tournais 42",
+          "address": "Rue de Tounais 42",
           "country": "BE"
         }
     Course: