# Introduction à l’API PDF Blocks

Ce qu’est PDF Blocks, le modèle que suit chaque action et le catalogue de tout ce que l’API sait faire.

PDF Blocks est une API HTTP sécurisée, rapide et *stateless* pour travailler avec
des documents PDF. Envoyez un document, nommez une action et récupérez le PDF
traité directement dans la réponse. Il n’y a aucun état de compte à gérer, rien
n’est stocké une fois la requête terminée et il n’y a aucun SDK à installer :
chaque action est un seul appel HTTPS authentifié, que vous pouvez faire depuis
n’importe quel langage.

## Le modèle mental

Un PDF entre, un PDF sort. Chaque action est une transformation pure : elle prend
un document (et quelques paramètres), renvoie un nouveau document et ne conserve
rien. Vous envoyez du `multipart/form-data` avec votre PDF dans un champ `file`,
et une action à sortie unique répond `200 OK` avec `application/pdf`, le document
terminé constituant le corps de la réponse.

Comme chaque sortie est elle-même un PDF valide, elle constitue une entrée valide
pour l’action suivante. Les actions sont donc composables : fusionnez plusieurs
fichiers, apposez un filigrane sur le résultat, puis chiffrez-le, chaque étape
alimentant la suivante. Voir
[Enchaîner les actions](/docs/api/chaining-actions) pour construire un pipeline
sans jamais toucher au disque.

## Le catalogue d’actions

Dix-sept actions, groupées par capacité. Chacune renvoie à sa référence complète.

### Fusionner et diviser

<CardGroup cols={3}>
  <Card title="Fusionner des documents" href="/docs/api/merge-pdf-documents">
    Combinez une liste ordonnée de PDF en un seul document.
  </Card>
  <Card title="Diviser par nombre de pages" href="/docs/api/split-pdf-by-page-count">
    Découpez en fragments de taille fixe.
  </Card>
  <Card title="Diviser à une page" href="/docs/api/split-pdf-at-page">
    Découpez au point de coupure de votre choix.
  </Card>
  <Card title="Diviser par taille" href="/docs/api/split-pdf-by-file-size">
    Limitez la taille en octets de chaque partie.
  </Card>
  <Card title="Diviser en groupes de pages" href="/docs/api/split-pdf-into-page-groups">
    Groupez les pages selon un motif que vous définissez.
  </Card>
</CardGroup>

### Filigranes

<CardGroup cols={3}>
  <Card title="Ajouter un filigrane texte" href="/docs/api/add-text-watermark-to-pdf">
    Apposez jusqu’à trois lignes de texte.
  </Card>
  <Card title="Ajouter un filigrane image" href="/docs/api/add-image-watermark-to-pdf">
    Apposez un logo ou une image.
  </Card>
</CardGroup>

### Mots de passe et sécurité

<CardGroup cols={3}>
  <Card title="Ajouter un mot de passe" href="/docs/api/add-password-to-pdf">
    Chiffrez un document.
  </Card>
  <Card title="Supprimer le mot de passe" href="/docs/api/remove-password-from-pdf">
    Déchiffrez un document dont vous connaissez le mot de passe.
  </Card>
  <Card title="Ajouter des restrictions" href="/docs/api/add-restrictions-to-pdf">
    Définissez les indicateurs d’autorisation.
  </Card>
  <Card title="Supprimer les restrictions" href="/docs/api/remove-restrictions-from-pdf">
    Effacez les indicateurs d’autorisation.
  </Card>
  <Card title="Supprimer les signatures" href="/docs/api/remove-signatures-from-pdf">
    Supprimez les signatures numériques.
  </Card>
</CardGroup>

### Pages

<CardGroup cols={3}>
  <Card title="Extraire des pages" href="/docs/api/extract-pages-from-pdf">
    Conservez un sous-ensemble de pages.
  </Card>
  <Card title="Supprimer des pages" href="/docs/api/remove-pages-from-pdf">
    Écartez un sous-ensemble de pages.
  </Card>
  <Card title="Faire pivoter des pages" href="/docs/api/rotate-pages-in-pdf">
    Faites pivoter les pages de 90°, 180° ou 270°.
  </Card>
  <Card title="Inverser les pages" href="/docs/api/reverse-pages-of-pdf">
    Inversez l’ordre des pages.
  </Card>
  <Card title="Réorganiser les pages" href="/docs/api/reorder-pages-of-pdf">
    Réorganisez les pages dans n’importe quel ordre.
  </Card>
</CardGroup>

Pour la vue complète, avec la convention de nommage, la façon dont les actions se
composent et l’endroit où chacune est documentée, voir
[Vue d’ensemble des actions](/docs/api/actions-overview).

## Ce qui la distingue

- **Rapide.** Les actions sont des transformations à but unique, sans file
  d’attente ni aller-retour. Vous envoyez une requête et écrivez le résultat
  directement dans un fichier.
- **Sécurisée et stateless.** Les requêtes ne circulent qu’en HTTPS et
  s’authentifient avec une clé secrète. Les documents sont traités dans la région
  et ne sont jamais stockés : une fois la réponse écrite, il ne reste rien.
- **Résidence régionale des données.** Le même catalogue tourne dans dix régions :
  vos documents peuvent donc être traités là où votre conformité l’exige. Dirigez
  une requête vers l’URL de base de la région et tout le reste est identique.

| Région           | URL de base                       |
| ---------------- | --------------------------------- |
| Global           | `https://api.pdfblocks.com`       |
| États-Unis       | `https://us.api.pdfblocks.com`    |
| HIPAA États-Unis | `https://hipaa.api.pdfblocks.com` |
| Union européenne | `https://eu.api.pdfblocks.com`    |
| Royaume-Uni      | `https://uk.api.pdfblocks.com`    |
| Canada           | `https://ca.api.pdfblocks.com`    |
| Australie        | `https://au.api.pdfblocks.com`    |
| Japon            | `https://jp.api.pdfblocks.com`    |
| Inde             | `https://in.api.pdfblocks.com`    |
| Brésil           | `https://br.api.pdfblocks.com`    |

Voir [Régions et résidence des données](/docs/api/regions-and-data-residency)
pour tous les détails.

## Et maintenant

<CardGroup cols={2}>

<Card title="Démarrage rapide" href="/docs/api/quickstart">
  Faites votre premier appel authentifié et obtenez un PDF traité en cinq minutes.
</Card>

<Card title="Authentification" href="/docs/api/authentication">
  Obtenez une clé d’API et envoyez-la correctement à chaque requête.
</Card>

</CardGroup>