# 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).