Ajout d'exemples pour les responses

responses/erreur/forbidden.yaml

@@ -1,5 +1,8 @@
-description: Acces interdit
+description: L’utilisateur souhaitant accéder à la ressource n’a pas les droits d’accès suffisants
 content:
   application/json:
     schema:
-      $ref: ../../schemas/erreur/erreur.yaml
+      $ref: ../../schemas/erreur/erreur.yaml
+    example:
+      code: 403
+      message: Le serveur comprend la requête mais refuse de l'autoriser.

responses/erreur/internalServerError.yaml

@@ -2,4 +2,7 @@ description: Une erreur est survenue sur le serveur
 content:
   application/json:
     schema:
-      $ref: ../../schemas/erreur/erreur.yaml
+      $ref: ../../schemas/erreur/erreur.yaml
+    example:
+      code: 500
+      message: Le serveur a rencontré un problème inattendu qui l'empêche de répondre à la requête

responses/erreur/notfound.yaml

@@ -2,4 +2,7 @@ description: La ressource n'a pas été trouvée
 content:
   application/json:
     schema:
-      $ref: ../../schemas/erreur/erreur.yaml
+      $ref: ../../schemas/erreur/erreur.yaml
+    example:
+      code: 404
+      message: Le serveur ne peut pas trouver la ressource demandée

responses/erreur/unauthorized.yaml

@@ -2,4 +2,7 @@ description: L'utilisateur souhaitant accéder à la ressource n'est pas authent
 content:
   application/json:
     schema:
-      $ref: ../../schemas/erreur/erreur.yaml
+      $ref: ../../schemas/erreur/erreur.yaml
+    example:
+      code: 401
+      message: La requête n'a pas été effectuée car il manque des informations d'authentification valides pour la ressource visée

responses/erreur/unsupportedMediaType.yaml

@@ -2,4 +2,7 @@ description: L’opération ne peut pas être effectuée car certaines données
 content:
   application/json:
     schema:
-      $ref: ../../schemas/erreur/erreur.yaml
+      $ref: ../../schemas/erreur/erreur.yaml
+    example:
+      code: 415
+      message: Le serveur refuse la requête car le format de la charge utile (payload) n'est pas pris en charge