Enable Access to API PART v3 swagger

Url is not accessible unless you type it in your browser for now.
This is intended as we can share our url to specific people and continue
our review.
This will also allow syntax checking on the siade_staging_data
repository.

This commit can be reverted once the v3 will be the main swagger on the
siade repository. This has been specified in the dedicated issue on
linear.

app/controllers/api_particulier/pages_controller.rb

@@ -29,6 +29,10 @@ def redoc
     render 'shared/pages/redoc'
   end
 
+  def redoc_v3
+    render 'shared/pages/redoc_v3'
+  end
+
   def mentions
     render 'shared/pages/mentions'
   end

app/services/abstract_open_api_definition.rb

@@ -38,13 +38,17 @@ def open_api_without_deprecated_paths_definition_content
     backend.merge('paths' => paths).to_yaml
   end
 
-  # rubocop:disable Security/Open
   def open_api_definition_content
+    open_api_remote_url_definition_content(remote_url)
+  end
+
+  # rubocop:disable Security/Open
+  def open_api_remote_url_definition_content(url)
     if load_local?
       local_path.read
     else
-      Rails.cache.fetch(remote_url, expires_in: 1.hour) do
-        URI.open(remote_url).read
+      Rails.cache.fetch(url, expires_in: 1.hour) do
+        URI.open(url).read
       end
     end
   rescue StandardError, OpenURI::HTTPError => e

app/services/api_particulier/open_api_definition.rb

@@ -1,10 +1,24 @@
 class APIParticulier::OpenAPIDefinition < AbstractOpenAPIDefinition
+  def open_api_v3_definition_content
+    open_api_remote_url_definition_content(remote_url_v3)
+  end
+
   protected
 
   def local_path
     Rails.root.join('config/api-particulier-openapi.yml')
   end
 
+  def remote_url_v3
+    if Rails.env.sandbox?
+      'https://sandbox.particulier.api.gouv.fr/api/open-api-v3.yml'
+    elsif Rails.env.staging? || Rails.env.development?
+      'https://staging.particulier.api.gouv.fr/api/open-api-v3.yml'
+    else
+      'https://particulier.api.gouv.fr/api/open-api-v3.yml'
+    end
+  end
+
   def remote_url
     if Rails.env.sandbox?
       'https://sandbox.particulier.api.gouv.fr/api/open-api.yml'

app/views/shared/pages/redoc_v3.html.erb

@@ -0,0 +1,42 @@
+<div class="fr-container">
+  <div class="">
+    <h1>
+      <%= t('.title') %>
+    </h1>
+
+    <p>
+      <%= t('.description', api_name: api_name).html_safe %>
+    </p>
+  </div>
+</div>
+
+<div class="fr-mt-5w" id="redoc_container">
+</div>
+
+<script>
+  function initRedoc() {
+    var uri = '<%= api_particulier_openapi_v3_definition_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>
+

bin/download_latest_open_api_definitions.sh

@@ -3,5 +3,8 @@
 wget "https://particulier.api.gouv.fr/api/open-api.yml" \
   -O config/api-particulier-openapi.yml
 
+wget "https://particulier.api.gouv.fr/api/open-api-v3.yml" \
+  -O config/api-particulier-openapi-v3.yml
+
 wget "https://entreprise.api.gouv.fr/v3/openapi-entreprise.yaml" \
   -O config/api-entreprise-v3-openapi.yml