Swagger docs

app/controllers/api/v1/dossiers_controller.rb

@@ -1,5 +1,26 @@
 class API::V1::DossiersController < APIController
 
+  swagger_controller :dossiers, "Dossiers"
+
+  swagger_api :index do
+    summary "Récupérer la liste de ses dossiers."
+    param :path, :procedure_id, :integer, "Procédure ID"
+    param :query, :token, :integer, "Admin TOKEN"
+    response :ok, "Success", :Dossier
+    response :unauthorized
+    response :not_found
+  end
+
+  swagger_api :show do
+    summary "Récupérer le détails d'un dossier."
+    param :path, :procedure_id, :integer, "Procédure ID"
+    param :path, :id, :integer, "Dossier ID"
+    param :query, :token, :integer, "Admin TOKEN"
+    response :ok, "Success", :Dossier
+    response :unauthorized
+    response :not_found
+  end
+
   def index
     procedure = current_administrateur.procedures.find(params[:procedure_id])
     dossiers = procedure.dossiers.where.not(state: :draft).paginate(page: params[:page])

app/controllers/api/v1/procedures_controller.rb

@@ -1,4 +1,16 @@
 class API::V1::ProceduresController < APIController
+
+  swagger_controller :procedures, "Procédures"
+
+  swagger_api :show do
+    summary "Récupérer la liste de ses procédures."
+    param :path, :id, :integer, "Procédure ID"
+    param :query, :token, :integer, "Admin TOKEN"
+    response :ok, "Success", :Procedure
+    response :unauthorized
+    response :not_found
+  end
+
   def show
     @procedure = current_administrateur.procedures.find(params[:id]).decorate
 
@@ -7,5 +19,4 @@ class API::V1::ProceduresController < APIController
     Rails.logger.error(e.message)
     render json: {}, status: 404
   end
-
 end