Add developers documentation

Use redoc to make OpenAPI file available on the site

app/controllers/open_api_controller.rb

@@ -0,0 +1,9 @@
+class OpenAPIController < ApplicationController
+  include Authentication
+
+  allow_unauthenticated_access
+
+  layout 'application'
+
+  def show; end
+end

app/views/open_api/show.html.erb

@@ -0,0 +1,29 @@
+<div id="redoc_container">
+</div>
+
+<script>
+  function initRedoc() {
+    var uri = '<%= open_api_v1_path %>';
+
+    Redoc.init(
+      uri,
+      {
+        jsonSampleExpandLevel: 'all',
+        expandResponses: '200',
+        expandSingleSchemaField: true,
+        schemaExpansionLevel: 'all'
+      },
+      document.getElementById('redoc_container')
+    )
+  }
+
+  var redocScript = document.createElement("script");
+
+  redocScript.src = "https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js";
+
+  redocScript.onload = function () {
+    initRedoc();
+  };
+
+  document.documentElement.firstChild.appendChild(redocScript);
+</script>

config/routes.rb

@@ -86,7 +86,8 @@
     skip_controllers :applications, :authorized_applications
   end
 
-  get '/api-docs/v1.yaml', to: ->(env) { [200, { 'Content-Type' => 'application/yaml' }, [File.read(Rails.root.join('config/openapi/v1.yaml'))]] }
+  get '/api-docs/v1.yaml', to: ->(env) { [200, { 'Content-Type' => 'application/yaml', 'Content-Disposition' => 'inline;filename="datapass-v1.yaml"' }, [File.read(Rails.root.join('config/openapi/v1.yaml'))]] }, as: :open_api_v1
+  get '/developpeurs/documentation', to: 'open_api#show'
 
   namespace :api do
     resources :frontal, only: :index

features/developpeurs/documentation.feature

@@ -0,0 +1,9 @@
+# language: fr
+
+Fonctionnalité: Développeurs: consultation de la documentation
+  @javascript
+
+  Scénario: Je peux voir la documentation OpenAPI de manière jolie
+    Quand je me rends sur le chemin "/developpeurs/documentation"
+    Alors la page contient "API DataPass"
+

features/step_definitions/web_steps.rb

@@ -2,6 +2,10 @@
   visit root_path
 end
 
+Quand("je me rends sur le chemin {string}") do |string|
+  visit string
+end
+
 Quand('print the page') do
   log page.body
 end