# Prise en main Comment ajouter une action PDF Blocks à un flux Power Automate et la connecter à votre compte avec une clé d’API. PDF Blocks est un connecteur pour Power Automate, Power Apps et Azure Logic Apps. Ce guide se concentre sur Power Automate, mais vous pouvez en appliquer l’essentiel à Azure Logic Apps. ## Prérequis Pour commencer à utiliser PDF Blocks, il vous faut : - Un plan Power Automate payant, par utilisateur ou par flux. - Un compte PDF Blocks. Si vous n’en avez pas, [créez un compte gratuit](https://accounts.pdfblocks.com/signup) : le plan Free ne demande aucune carte bancaire. ## Votre clé d’API Vous pouvez obtenir votre clé d’API dans votre [dashboard](https://accounts.pdfblocks.com). Cette clé d’API donne uniquement à son détenteur (par exemple votre compte Power Automate) l’accès au service PDF Blocks. Quelqu’un qui possède la clé d’API ne peut pas accéder à vos documents ni à vos données d’entrée privées, car nous ne stockons ni vos documents ni vos données. Conservez-la tout de même en lieu sûr et ne la publiez pas. Vous pouvez révoquer une clé et en générer une nouvelle à tout moment depuis le dashboard. ## Étape 1 : choisir PDF Blocks Dans un flux Power Automate, ajoutez une nouvelle action. Dans le volet **Add an action**, recherchez PDF Blocks. <Frame caption="Recherche de PDF Blocks dans le volet Add an action."> <img src="/images/power-automate/getting-started/search-for-pdf-blocks.png" alt="Recherche de PDF Blocks dans le volet Add an action de Power Automate" /> </Frame> La recherche ne place pas toujours PDF Blocks en tête : faites défiler les résultats jusqu’au groupe **PDF Blocks**. Si vous ne voyez pas l’action souhaitée, sélectionnez **Afficher plus** (*See more*) dans ce groupe pour lister toutes les actions PDF Blocks, puis choisissez celle qu’il vous faut. ## Étape 2 : créer une connexion La première fois que vous ajoutez une action PDF Blocks à un flux, Power Automate vous demande quelques paramètres pour créer une connexion : <Frame caption="Création d’une connexion dans Power Automate."> <img src="/images/power-automate/getting-started/create-a-connection-global.png" alt="Le volet de création de connexion dans Power Automate, avec le serveur par défaut" /> </Frame> Paramètres de la connexion : - Dans **Connection name**, saisissez le texte que vous voulez utiliser comme nom de la connexion. Dans l’exemple ci-dessus, nous avons utilisé « PDF Blocks Default ». - Dans **API Key**, saisissez votre clé d’API PDF Blocks. À mesure que vous la saisissez, elle est masquée par des points comme n’importe quel autre mot de passe. - Dans **Server Hostname**, laissez le champ vide pour utiliser le serveur par défaut (`api.pdfblocks.com`). Appuyez sur **Créer un nouveau** (*Create new*) pour créer votre connexion. Une fois la connexion créée, vous pouvez commencer à utiliser PDF Blocks dans n’importe lequel de vos flux. ### Traiter les documents dans une région précise Laissez **Server Hostname** vide et PDF Blocks achemine chaque requête vers l’infrastructure la plus proche pour obtenir la latence la plus faible. Pour que le traitement reste dans une juridiction précise, saisissez plutôt le nom d’hôte de cette région. Par exemple, pour traiter exclusivement sur des serveurs européens, écrivez `eu.api.pdfblocks.com` dans le champ **Server Hostname** avant de créer la connexion : <Frame caption="Utilisez eu.api.pdfblocks.com pour traiter les documents dans l’UE."> <img src="/images/power-automate/getting-started/create-a-connection-eu.png" alt="Le volet de création de connexion dans Power Automate, avec le nom d’hôte du serveur de l’UE" /> </Frame> Les régions disponibles, et le nom d’hôte à saisir pour chacune, dépendent de votre plan : | Région | Server Hostname | Disponible avec | | ------------------- | ------------------------- | ---------------------------------- | | Global (par défaut) | _Laisser vide_ | Tous les plans | | États-Unis | `us.api.pdfblocks.com` | Starter et Business | | Union européenne | `eu.api.pdfblocks.com` | Starter et Business | | Royaume-Uni | `uk.api.pdfblocks.com` | Business | | Canada | `ca.api.pdfblocks.com` | Business | | Australie | `au.api.pdfblocks.com` | Business | | Japon | `jp.api.pdfblocks.com` | Business | | Inde | `in.api.pdfblocks.com` | Business | | Brésil | `br.api.pdfblocks.com` | Business | | HIPAA États-Unis | `hipaa.api.pdfblocks.com` | Business (nécessite un BAA signé) | Consultez [Régions et résidence des données](/docs/api/regions-and-data-residency) pour tous les détails sur chaque endpoint. ## Obtenir de l’aide Besoin d’un coup de main ? Ouvrez un ticket de support depuis **Support** dans votre [dashboard](https://accounts.pdfblocks.com). Décrivez le problème (vous pouvez joindre des fichiers) et nous vous répondrons dans le même fil, avec des notifications par e-mail à mesure que la conversation avance. Si vous ne pouvez pas accéder à votre dashboard, écrivez-nous à [support@pdfblocks.com](mailto:support@pdfblocks.com).