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
+    example:
+      code: 403
+      message: Le serveur comprend la requête mais refuse de l'autoriser.

responses/erreur/internalServerError.yaml

@@ -3,3 +3,6 @@ content:
   application/json:
     schema:
       $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

@@ -3,3 +3,6 @@ content:
   application/json:
     schema:
       $ref: ../../schemas/erreur/erreur.yaml
+    example:
+      code: 404
+      message: Le serveur ne peut pas trouver la ressource demandée

responses/erreur/unauthorized.yaml

@@ -3,3 +3,6 @@ content:
   application/json:
     schema:
       $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

@@ -3,3 +3,6 @@ content:
   application/json:
     schema:
       $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