Merge pull request #9828 from mfo/US/doc-api-link-in-user-profile

amelioration(doc.api): ETQ administrateur, j'ai plus facilement accès à la bonne doc des API

app/components/profile/api_token_card_component/api_token_card_component.en.yml

@@ -1,5 +1,6 @@
 en:
   tokens_title: API identification tokens
-  first_paragraph: These tokens are needed to make calls to the
+  first_paragraph_html: |
+    These tokens are needed to make calls to the API of %{application_name}. You can <strong>click on </strong><a target=_blank rel="noopener" href="%{api_doc_url}" title="See %{application_name} API documentation">this link</a> to check our documentation
   second_paragraph: If you already have applications that use a token and you revoke it, access to the API will be blocked for those applications.
   action: Create and display a new token

app/components/profile/api_token_card_component/api_token_card_component.fr.yml

@@ -1,5 +1,6 @@
 fr:
   tokens_title: Jetons d’identification de l’API (token)
-  first_paragraph: Ces jetons sont nécessaire pour effectuer des appels vers l’API de
+  first_paragraph_html: |
+    Ces jetons sont nécessaires pour effectuer des appels vers l’API de %{application_name}. Vous pouvez <strong>consulter notre documentation en suivant </strong><a target="_blank" rel="noopener" href="%{api_doc_url}" title="Voir la documentation de l'API de %{application_name}">ce lien</a>
   second_paragraph: Si vous avez déjà des applications qui utilisent un jeton et vous le révoquez, l’accès à l’API sera bloqué pour ces applications.
   action: Créer et afficher un nouveau jeton

app/components/profile/api_token_card_component/api_token_card_component.html.haml

@@ -2,8 +2,7 @@
   .card-title
     = t('.tokens_title')
   %p
-    = t('.first_paragraph')
-    #{APPLICATION_NAME}.
+    = t('.first_paragraph_html', application_name: APPLICATION_NAME, api_doc_url: API_DOC_URL)
   %p
     = t('.second_paragraph')
 

app/views/administrateurs/procedures/_informations.html.haml

@@ -118,8 +118,9 @@
     = f.label :web_hook_url, class: 'fr-label' do
       Lien de rappel HTTP (webhook)
     %p.fr-hint-text
-      Vous pouvez définir un lien de rappel HTTP (aussi appelé webhook) pour informer un service tiers du changement de l'état d’un dossier de cette démarche sur #{APPLICATION_NAME}.
-      = link_to("Consulter la documentation du webhook", WEBHOOK_DOC_URL, target: "_blank", rel: "noopener")
+      %strong Les webhooks sont maintenant dépréciés
+      Nous vous recommandons d'utiliser l'API GraphQL en faisant du polling,
+      = link_to "voici un exemple d'implementation ", WEBHOOK_ALTERNATIVE_DOC_URL, rel: "noopener", target: "_blank", title: "Voir une implémentation alternative à l'ancien système de webhook"
     = f.text_field :web_hook_url, class: 'fr-input', placeholder: 'https://callback.exemple.fr/'
 
   = render Dsfr::CalloutComponent.new(title: "Date limite de dépôt des dossiers") do |c|

config/initializers/02_urls.rb

@@ -35,8 +35,9 @@ CGU_URL = ENV.fetch("CGU_URL", [DOC_URL, "cgu"].join("/"))
 MENTIONS_LEGALES_URL = ENV.fetch("MENTIONS_LEGALES_URL", "/mentions-legales")
 ACCESSIBILITE_URL = ENV.fetch("ACCESSIBILITE_URL", "/declaration-accessibilite")
 ROUTAGE_URL = ENV.fetch("ROUTAGE_URL", [DOC_URL, "/pour-aller-plus-loin/routage"].join("/"))
-API_DOC_URL = [DOC_URL, "pour-aller-plus-loin", "graphql"].join("/")
+API_DOC_URL = [DOC_URL, "api-graphql"].join("/")
 WEBHOOK_DOC_URL = [DOC_URL, "pour-aller-plus-loin", "webhook"].join("/")
+WEBHOOK_ALTERNATIVE_DOC_URL = [DOC_URL, "api-graphql", "cas-dusages-exemple-dimplementation", "synchroniser-les-dossiers-modifies-sur-ma-demarche"].join("/")
 ARCHIVAGE_DOC_URL = [DOC_URL, "pour-aller-plus-loin", "archivage-longue-duree-des-demarches"].join("/")
 DOC_INTEGRATION_MONAVIS_URL = [DOC_URL, "tutoriels", "integration-du-bouton-mon-avis"].join("/")
 DOC_PROCEDURE_EXPIRES_URL = [DOC_URL, "expiration-et-suppression-des-dossiers"].join("/")