MAJ des urls pour la partie note en fonction des spécifications techniques

openapi.yaml

@@ -31,28 +31,22 @@ paths:
   #Note
   /notes/:
     $ref: ./paths/note/notes.yaml
-  /notes/nouvellenote:
-    $ref: ./paths/note/nouvelleNote.yaml
   /notes/{idNote}:
-    $ref: ./paths/note/noteById.yaml
-  /notes/{idNote}/updateNote:
-    $ref: ./paths/note/updateNote.yaml
-  /notes/auteur/{idReferent}:
-    $ref: ./paths/note/notesAuteur.yaml
-  /notes/auteur/{idReferent}/collaborateur/{idCollaborateur}:
-    $ref: ./paths/note/notesParCollaborateur.yaml
-  /notes/{idNote}/supprimer:
-    $ref: ./paths/note/supprimerNote.yaml
+    $ref: ./paths/note/notesIdNote.yaml
+  /notes/{idAuteur}:
+    $ref: ./paths/note/notesIdAuteur.yaml
+  /notes/{idAuteur}/count:
+    $ref: ./paths/note/notesIdAuteurCount.yaml
 
   #Referent
-  /referents:
-    $ref: ./paths/referents/referents.yaml
-  /referents/{idReferent}:
-    $ref: ./paths/referents/referentById.yaml
-  /referents/collaborateur/{idCollaborateur}:
-    $ref: ./paths/referents/referentsByCollaborateur.yaml
-  /referents/actuel/collaborateur/{idCollaborateur}:
-    $ref: ./paths/referents/referentActuelByCollaborateur.yaml
+  #/referents:
+    #$ref: ./paths/referents/referents.yaml
+  #/referents/{idReferent}:
+    #$ref: ./paths/referents/referentById.yaml
+  #/referents/collaborateur/{idCollaborateur}:
+    #$ref: ./paths/referents/referentsByCollaborateur.yaml
+  #/referents/actuel/collaborateur/{idCollaborateur}:
+    #$ref: ./paths/referents/referentActuelByCollaborateur.yaml
 
   #EP
   /ep:

parameters/path/idAuteur.yaml

@@ -4,4 +4,4 @@ schema:
   type: string
   format: uuid
 required: true
-description: id de l'auteur
+description: Id de l'auteur

paths/note/noteById.yaml

@@ -1,16 +0,0 @@
-get:
-  tags:
-    - notes
-  operationId: getNoteById
-  description: Récupérer une note par son id
-  parameters:
-    - $ref: ../../parameters/path/idNote.yaml
-  responses:
-    '200': 
-      $ref: ../../responses/note/getNote.yaml
-  
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml
-
-    '404':
-      $ref: ../../responses/erreur/notFound.yaml

paths/note/notes.yaml

@@ -1,16 +1,22 @@
-get:
+post:
   tags:
     - notes
-  operationId: getNotes
-  description: Récupérer toutes les notes
-  parameters:
-    - $ref: ../../parameters/query/asc.yaml
-    - $ref: ../../parameters/query/numPage.yaml
-    - $ref: ../../parameters/query/parPage.yaml
-    - $ref: ../../parameters/query/texte.yaml
-    - $ref: ../../parameters/query/tri.yaml
+  operationId: addNote
+  description: Créer une nouvelle note.
+  requestBody:
+    $ref: ../../requestbodies/note.yaml
   responses:
-    '200':
-      $ref: ../../responses/note/getListeNotes.yaml
+    '201':
+      $ref: ../../responses/note/noteCreee.yaml
+
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
     '403':
       $ref: ../../responses/erreur/forbidden.yaml
+
+    '415':
+      $ref: ../../responses/erreur/unsupportedMediaType.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml

paths/note/notesIdAuteur.yaml

@@ -1,11 +1,11 @@
 get:
   tags:
     - notes
-  operationId: getNotesByAuteur
-  description: Récupérer les notes d'une personne a écrite
+  operationId: getNotesAuteur
+  description: Récupérer les notes d’un auteur.
   parameters:
+    - $ref: ../../parameters/path/idAuteur.yaml
     - $ref: ../../parameters/query/asc.yaml
-    - $ref: ../../parameters/path/idReferent.yaml
     - $ref: ../../parameters/query/numPage.yaml
     - $ref: ../../parameters/query/parPage.yaml
     - $ref: ../../parameters/query/texte.yaml
@@ -14,8 +14,14 @@ get:
     '200':
       $ref: ../../responses/note/getListeNotes.yaml
 
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
     '403':
       $ref: ../../responses/erreur/forbidden.yaml
 
     '404':
       $ref: ../../responses/erreur/notFound.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml

paths/note/notesIdAuteurCount.yaml

@@ -0,0 +1,27 @@
+get:
+  tags:
+    - notes
+  operationId: getNotesAuteurCount
+  description: Récupérer le nombre total de notes d’un auteur.
+  parameters:
+    - $ref: ../../parameters/path/idAuteur.yaml
+    - $ref: ../../parameters/query/asc.yaml
+    - $ref: ../../parameters/query/numPage.yaml
+    - $ref: ../../parameters/query/parPage.yaml
+    - $ref: ../../parameters/query/texte.yaml
+    - $ref: ../../parameters/query/tri.yaml
+  responses:
+    '200':
+      $ref: ../../responses/note/getCountNote.yaml
+
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '404':
+      $ref: ../../responses/erreur/notFound.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml

paths/note/notesIdNote.yaml

@@ -0,0 +1,65 @@
+get:
+  tags:
+    - notes
+  operationId: getNoteById
+  description: Récupérer une note par son id.
+  parameters:
+    - $ref: ../../parameters/path/idNote.yaml
+  responses:
+    '200': 
+      $ref: ../../responses/note/getNote.yaml
+  
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '404':
+      $ref: ../../responses/erreur/notFound.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml
+put:
+  tags:
+    - notes
+  operationId: updateNote
+  description: Modifier une note.
+  parameters:
+    - $ref: ../../parameters/path/idNote.yaml
+  requestBody:
+    $ref: ../../requestbodies/note.yaml
+  responses:
+    '200':
+      $ref: ../../responses/note/updateNote.yaml
+
+    '401':
+      $ref: ../../responses/erreur/unauthorized.yaml
+
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '404':
+      $ref: ../../responses/erreur/notFound.yaml
+
+    '415':
+      $ref: ../../responses/erreur/unsupportedMediaType.yaml
+
+    '500':
+      $ref: ../../responses/erreur/internalServerError.yaml
+delete:
+  tags:
+    - notes
+  operationId: deleteNote
+  description: Supprimer une note
+  parameters: 
+    - $ref: ../../parameters/path/idNote.yaml
+  responses:
+    '204':
+      $ref: ../../responses/note/noteSupprimee.yaml
+  
+    '403':
+      $ref: ../../responses/erreur/forbidden.yaml
+
+    '404':
+      $ref: ../../responses/erreur/notFound.yaml

paths/note/notesParCollaborateur.yaml

@@ -1,22 +0,0 @@
-get:
-  tags:
-    - notes
-  operationId: getNotesByCollaborateur
-  description: Récupérer une note par son id
-  parameters:
-    - $ref: ../../parameters/query/asc.yaml
-    - $ref: ../../parameters/path/idCollaborateur.yaml
-    - $ref: ../../parameters/path/idReferent.yaml
-    - $ref: ../../parameters/query/numPage.yaml
-    - $ref: ../../parameters/query/parPage.yaml
-    - $ref: ../../parameters/query/texte.yaml
-    - $ref: ../../parameters/query/tri.yaml
-  responses:
-    '200': 
-      $ref: ../../responses/note/getListeNotes.yaml
-  
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml
-
-    '404':
-      $ref: ../../responses/erreur/notFound.yaml

paths/note/nouvelleNote.yaml

@@ -1,12 +0,0 @@
-post:
-  tags:
-    - notes
-  operationId: nouvelleNote
-  description: Ajouter une nouvelle note
-  requestBody:
-    $ref: ../../requestbodies/note.yaml
-  responses:
-    '201':
-      $ref: ../../responses/note/noteCreee.yaml
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml

paths/note/supprimerNote.yaml

@@ -1,16 +0,0 @@
-delete:
-  tags:
-    - notes
-  operationId: deleteNote
-  description: Supprimer une note
-  parameters: 
-    - $ref: ../../parameters/path/idNote.yaml
-  responses:
-    '204':
-      $ref: ../../responses/note/noteSupprimee.yaml
-  
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml
-
-    '404':
-      $ref: ../../responses/erreur/notFound.yaml

paths/note/updateNote.yaml

@@ -1,18 +0,0 @@
-put:
-  tags:
-    - notes
-  operationId: updateNote
-  description: Mettre à jour une note
-  parameters:
-    - $ref: ../../parameters/path/idNote.yaml
-  requestBody:
-    $ref: ../../requestbodies/note.yaml
-  responses:
-    '200':
-      $ref: ../../responses/note/updateNote.yaml
-
-    '201':
-      $ref: ../../responses/note/noteCreee.yaml
-
-    '403':
-      $ref: ../../responses/erreur/forbidden.yaml

responses/erreur/notfound.yaml

@@ -1,4 +1,4 @@
-description: Ressource n'a pas été trouvée
+description: La ressource n'a pas été trouvée
 content:
   application/json:
     schema:

responses/erreur/unsupportedMediaType.yaml

@@ -0,0 +1,5 @@
+description: L’opération ne peut pas être effectuée car certaines données sont manquantes
+content:
+  application/json:
+    schema:
+      $ref: ../../schemas/erreur/erreur.yaml

responses/note/getCountNote.yaml

@@ -0,0 +1,7 @@
+description: OK
+content:
+  application/json:
+    schema:
+      type: integer
+      format: int64
+      description: Nombre total de notes

responses/note/noteCreee.yaml

@@ -1 +1,5 @@
 description: Note créée avec succès
+content:
+  application/json:
+    schema:
+      $ref: ../../schemas/note/detailsNote.yaml

responses/note/noteSupprimee.yaml

@@ -1 +1 @@
-description: Note supprimée 
+description: Note supprimée avec succès

responses/note/updateNote.yaml

@@ -1 +1,5 @@
-description: Note mise à jour avec succès
+description: Note modifiée avec succès
+content:
+  application/json:
+    schema:
+      $ref: ../../schemas/note/detailsNote.yaml