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 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
Combinez une liste ordonnée de PDF en un seul document.
Découpez en fragments de taille fixe.
Découpez au point de coupure de votre choix.
Limitez la taille en octets de chaque partie.
Groupez les pages selon un motif que vous définissez.
Filigranes
Apposez jusqu’à trois lignes de texte.
Apposez un logo ou une image.
Mots de passe et sécurité
Chiffrez un document.
Déchiffrez un document dont vous connaissez le mot de passe.
Définissez les indicateurs d’autorisation.
Effacez les indicateurs d’autorisation.
Supprimez les signatures numériques.
Pages
Conservez un sous-ensemble de pages.
Écartez un sous-ensemble de pages.
Faites pivoter les pages de 90°, 180° ou 270°.
Inversez l’ordre des pages.
Réorganisez les pages dans n’importe quel ordre.
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.
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 pour tous les détails.