API & SDK Rotation de pages PDF

Modifier définitivement l’orientation des pages

Ajustez l’orientation des documents avec précision et contrôle

L’API et le SDK « Rotation de pages PDF » offrent une solution robuste pour régler l’orientation des pages dans les documents PDF de façon programmatique. Conçue pour les équipes qui ont besoin d’une manipulation PDF fiable et performante, cette fonction permet de faire pivoter définitivement les pages à des angles précis sans compromettre l’intégrité du document.

Que vous construisiez des workflows documentaires, corrigiez des fichiers numérisés ou mettiez en place des systèmes de préparation de documents, notre fonction garantit des résultats cohérents sur tous les lecteurs et plateformes PDF. Contrairement à la rotation au niveau du lecteur, qui se réinitialise à la réouverture, notre solution modifie définitivement la structure du document, assurant que les pages conservent leur orientation quel que soit le logiciel de visualisation.

L’API et le SDK offrent un contrôle granulaire sur les pages à faire pivoter et les angles appliqués, ce qui les rend idéaux pour le traitement automatique en lot comme pour les applications interactives où les utilisateurs doivent corriger des pages spécifiques.

Fonctionnalités clés et capacités techniques

Sélection précise des pages

Sélectionnez exactement les pages à faire pivoter grâce à une syntaxe flexible prenant en charge les pages uniques, les intervalles ou l’ensemble du document. Les pages peuvent être indiquées via des valeurs séparées par des virgules (ex. « 1,3,5 ») ou par des intervalles avec tiret (ex. « 3-7 »). L’API traite intelligemment la sélection tout en conservant la structure logique et la numérotation.

Avantage technique: Inutile de scinder puis recombiner le document lorsque seules certaines pages doivent être pivotées, ce qui réduit la charge de traitement et préserve les métadonnées.

Angles de rotation multiples

Appliquez une rotation horaire selon trois angles prédéfinis :

  • 90 degrés (par défaut)

    Idéal pour passer du portrait au paysage

  • 270 degrés

    Équivalent à 90 degrés anti‑horaire

  • 180 degrés

    Pour corriger un contenu à l’envers

Chaque rotation modifie définitivement la structure interne du document, garantissant un affichage cohérent sur tous les lecteurs et appareils PDF.

Avantage technique: Un contrôle précis de l’orientation permet la correction automatisée de documents issus de diverses sources, sans intervention manuelle.

Modification permanente du document

Contrairement aux rotations côté lecteur, qui n’affectent que l’affichage, notre fonction écrit l’orientation directement dans le document. Le PDF pivoté conserve sa nouvelle orientation dans toute application, éliminant les réinitialisations inattendues et les ajustements répétés.

Avantage technique: Crée des documents véritablement corrigés qui conservent leur orientation tout au long du cycle de vie du document, sur tous les systèmes et applications.

Prise en charge des documents protégés par mot de passe

Traitez les PDF protégés en fournissant le mot de passe dans la requête API. L’authentification est sécurisée, la rotation s’effectue, et le document est renvoyé avec ses réglages de sécurité intacts.

Avantage technique: Maintient la sécurité du document tout au long du traitement sans compromettre les mesures de protection ni exiger des étapes de déchiffrement distinctes.

Architecture de traitement asynchrone

L’API fonctionne de manière asynchrone et renvoie immédiatement un ID d’opération, permettant à votre application de continuer pendant que la rotation s’effectue en arrière‑plan. Suivez l’état via l’endpoint /operation/v1/{operationId}/status.

Avantage technique: Empêche le blocage des threads de l’application pendant le traitement des documents, permettant une meilleure gestion des ressources et une meilleure expérience utilisateur dans vos applications.

Options d’intégration flexibles

Implémentez la rotation via notre API REST pour un traitement cloud ou via notre SDK pour un traitement local. Le SDK fournit des bibliothèques natives pour les principales plateformes, tandis que l’API est accessible depuis tout environnement capable d’effectuer des requêtes HTTP.

Avantage technique: Choisissez l’approche d’intégration qui correspond le mieux à votre architecture, à vos exigences de sécurité et à vos besoins de performance.

Implémentation technique

Implémentation de l’API REST

En cas de réussite, l’API renvoie le code 202 et un ID d’opération :

{
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
 }

Use this ID to check operation status and retrieve the rotated document when processing completes.

L’API de rotation suit les principes REST avec une structure d’endpoint simple :

POST/rotate-pdf/v1

The request uses multipart/form-data encoding with the following parameters:
Paramètre
File
Type
Binary
Description
Le fichier PDF à faire pivoter (max 10 Mo)
Paramètre
Password
Type
String
Description
Mot de passe optionnel pour documents protégés
Paramètre
Pages
Type
String
Description
Sélection des pages (ex. " 1,3,5-7 ")
Paramètre
RotateDegrees
Type
String
Description
Angle de rotation : 90, 180 ou 270 (défaut : 90)

Exemple d’implémentation SDK

Notre SDK fournit une interface de programmation native qui simplifie les opérations de rotation :


  // C# example
  using Avanquest.PDF;

var rotator = newPdfRotator();
rotator.RotatePages("input.pdf", "output.pdf",
pages: "1,3-5",
degrees: 90,
password: "optional-password");

Similar implementations are available for Java, Python, Node.js, and other supported languages, with consistent APIs across platforms.

Pourquoi notre solution de rotation se démarque

Conservation de la structure du document

Notre technologie fait pivoter les pages tout en préservant :
Recherche et sélection de texte
Champs de formulaire interactifs
Signets et liens internes
Métadonnées et propriétés du document
Signatures numériques (le cas échéant)

Cela garantit que vos documents restent pleinement fonctionnels après la rotation, contrairement aux solutions qui dégradent la qualité du document ou aplatissent les éléments interactifs.

Traitement optimisé pour la performance

Le moteur de rotation est conçu pour être économe en mémoire avec des algorithmes optimisés, adapté aux traitements en lot à haut volume comme aux requêtes à la demande.

Pour les documents volumineux, notre modèle de traitement asynchrone évite le blocage des ressources, permettant à votre application de rester réactive pendant que la rotation s’achève en arrière-plan.

Cohérence multiplateforme

Que le traitement des documents se fasse via l’API cloud ou le SDK local, les résultats de rotation sont identiques sur toutes les plateformes et dans tous les environnements. Cette cohérence élimine la charge de tests liée aux bibliothèques PDF spécifiques aux plateformes et garantit des résultats prévisibles quel que soit l’environnement de déploiement.

Cas d’usage courants

Workflows documentaires automatisés

Intégrez la rotation dans les pipelines de capture pour corriger automatiquement les problèmes d’orientation avant OCR ou archivage. La sélection ciblée des pages est idéale pour les documents numérisés à orientations mixtes.

Systèmes de préparation de documents

Ajoutez la rotation aux logiciels de préparation de documents pour permettre aux utilisateurs d’ajuster l’orientation avant impression, publication ou présentation. La rotation permanente garantit que les documents conservent l’orientation lorsqu’ils sont partagés.

Applications de traitement de formulaires

Corrigez les problèmes d’orientation dans les formulaires soumis afin d’assurer une extraction de données cohérente. Les champs de formulaire restent intacts après rotation.

Workflows de publication numérique

Préparez les PDF pour la publication numérique en garantissant une orientation uniforme, améliorant la lisibilité et l’apparence professionnelle.

Mise en route

Prérequis techniques

Pour l’API : client HTTP capable d’envoyer des requêtes POST multipart/form-data

Pour le SDK : Environnement de développement compatible avec le langage choisi

Taille maximale du fichier : 10 Mo par opération

-

-

Guide rapide

Obtenez une clé API via le Developer Portal

Choisissez la méthode d’intégration (API REST ou SDK)

Implémentez la rotation de base avec nos exemples de code

Testez avec différents types de documents et scénarios

Déployez en production

Ressources développeur

  • Documentation API complète
  • Référence SDK pour tous les langages pris en charge
  • Exemples de code pour les modèles d’implémentation courants
  • Guide de dépannage pour les problèmes d’intégration fréquents

Étapes suivantes