Supprimer des pages dans Word - Gestion des pages API
PDF4me Supprimer des pages de Word vous permet de supprimer des pages spécifiques ou des plages de pages de documents Word grâce à des options de sélection de pages flexibles. API Ce service traite les fichiers Word et supprime les pages en utilisant la suppression par plage (de la première page à la dernière page), la suppression par numéro de page spécifique (listes séparées par des virgules) et des modèles de suppression combinés. API reçoit le contenu des documents Word via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Grâce à la prise en charge d'un contrôle total sur la sélection des pages, l'optimisation des documents et le nettoyage du contenu, cette solution est idéale pour le perfectionnement des documents, la gestion du contenu et les flux de travail de préparation des documents.
Authentification de votre API Demande
Pour accéder au PDF4me REST APIChaque requête doit inclure des informations d'authentification valides. L'authentification garantit la sécurité des communications et confirme votre identité en tant qu'utilisateur autorisé. REST API.
Caractéristiques principales
- Sélection de page flexibleSupprimer des pages par plage, par numéros spécifiques ou par une combinaison des deux.
- Suppression basée sur la plageSupprimer les pages consécutives de la page de début à la page de fin
- Suppression de page spécifiqueSupprimer les pages individuellement en utilisant les numéros de page séparés par des virgules
- Optimisation des documents: Nettoyer les documents en supprimant le contenu indésirable
- Préservation du formatConserver la mise en forme et la structure originales du document
- Préservation des métadonnéesConserver les propriétés du document et les métadonnées personnalisées
- ValidationValidation automatique des numéros de page et gestion des erreurs
- Soutien culturelTraitement de documents spécifique à la langue
REST API Point de terminaison
Le PDF4me REST API utilise la norme HTTP méthodes d'interaction avec les ressources. Toutes les opérations de suppression de page sont effectuées via un point de terminaison unique :
- Méthode: POST
- Point final :
office/ApiV2Word/DeletePages
REST API Paramètres
Liste complète des paramètres pour la suppression de pages dans Word REST APILes paramètres sont organisés par catégorie pour une meilleure compréhension et une mise en œuvre plus aisée.
Important: Les paramètres marqués d'un astérisque (*) sont obligatoires. Au moins un paramètre de suppression de page (startPage, endPage ou pageNumbers) doit être fourni.
Paramètres requis
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| document* | Object | Référence du document. Doit contenir Nom (chaîne de caractères) : Nom du fichier Word avec l'extension .docx | { "Name": "document.docx" } |
| docContent* | Base64 | Contenu du document Word encodé en Base64 | UEsDBBQABgAIAAAA... |
Paramètres optionnels (au moins un requis pour la suppression de la page)
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| startPage | Integer | Numéro de la page de début (index à partir de 1). Numéro de la page à partir de laquelle la suppression commence. Doit être supérieur ou égal à 1 et inférieur ou égal au nombre de pages du document. Si seule la page de début est fournie, la suppression s'effectue de cette page jusqu'à la fin du document. Ne peut pas être supérieur à la page de fin. | 2 |
| endPage | Integer | Numéro de la page de fin (index à partir de 1). Numéro de la page à partir de laquelle la suppression doit s'arrêter. Doit être supérieur ou égal à startPage et inférieur ou égal au nombre de pages du document. La plage inclut les pages de début et de fin (suppression des deux pages). Peut être combiné avec pageNumbers pour des schémas de suppression complexes. | 5 |
| Numéros de page | String | Liste de numéros de pages à supprimer, séparés par des virgules. Format : « 1,3,4 » ou « 1-3,5,7-9 ». Peut être utilisé seul ou combiné avec startPage/endPage. Les numéros de page invalides sont ignorés. Exemple : « 2,4,6,8 » supprime les pages 2, 4, 6 et 8. | "2,4,6" |
| nom de la culture | String | Code de culture pour le traitement des documents (par exemple, « en-US », « de-DE », « fr-FR »). Valeur par défaut : null (aucun traitement spécifique à la culture). Affecte la langue et la mise en forme du document. | en-US |
Modes de suppression de page
Le API prend en charge plusieurs modes de suppression de pages :
- Suppression de plage: Utiliser
startPageetendPagesupprimer des pages consécutives - Suppression de page spécifique: Utiliser
pageNumberssupprimer des pages individuelles - Suppression combinéeUtilisez simultanément les paramètres de plage et les paramètres de page spécifiques.
- Supprimer pour terminer: À utiliser uniquement
startPagesupprimer de cette page pour terminer le document
Note: La numérotation des pages commence à 1 (la première page = 1, et non 0). Les numéros de page sont automatiquement validés par rapport au nombre total de pages du document.
Sortir
Le PDF4me Supprimer des pages de Word REST API renvoie des réponses différentes selon le mode de traitement. API renvoie le document Word sous forme de Base64chaîne encodée dans JSON format, et non sous forme de données binaires.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Traitement synchrone (par défaut)
Le API traite la requête et renvoie :
Code d'état : 200 OK
Type de contenu : application/json
Corps de la réponse :
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}
Champs de réponse :
- document (chaîne de caractères) : Le document Word dont les pages spécifiées ont été supprimées, encodé comme Base64 chaîne
- nom de fichier (chaîne de caractères) : Nom du fichier Word de sortie
- succès (booléen) : Indique si la requête a abouti.
- message d'erreur (chaîne de caractères ou null) : Détails de l’erreur en cas d’échec
Mode d'emploi :
- Extraire le
documentchamp du JSON réponse (Base64) - Décodez le Base64 chaîne permettant d'obtenir les données binaires d'un document Word
- Enregistrez ou traitez le fichier Word selon les besoins
Exemple (JavaScript) :
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
Traitement asynchrone
Comportement asynchrone (202) Accepted (avec interrogation) est contrôlé par la configuration du serveur, et non par un paramètre du corps de la requête. Lorsqu'il est activé, le API peut renvoyer un statut 202 avec un sondage URL dans le Location En-tête. Interroger l'en-tête. URL avec GET demandes jusqu'à ce que vous en receviez 200 OK avec la même forme de réponse (document, nom_de_fichier, succès, message_d'erreur).
Réponses d'erreur
Le API retours standard HTTP codes d'erreur avec détails de l'erreur :
- Paramètres de requête invalides
- Champs obligatoires manquants (
documentavecNom,docContent) - Au moins un critère de suppression de page requis (
startPage,endPage, ouNuméros de page) - Invalide Base64 encodage dans
docContent - Document Word invalide ou corrompu
startPagene peut pas être supérieur àendPage- Numéros de page invalides (hors limites du document)
- Invalide ou manquant API clé
- API clé non correctement Base64 encodé dans Authorization en-tête
- Manquant
Autorisation : de baseen-tête
- Erreur de traitement côté serveur
- Échec du traitement du document Word
- Échec de la suppression de la page
Format de réponse en cas d'erreur :
{
"error": "Error message describing what went wrong"
}
Détails du format de réponse
Important: Le API toujours retourne JSON, jamais directement de données Word binaires.
Structure de la réponse :
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
En-tête Content-Type :
- Succès:
application/json - Le document Word est intégré en tant que Base64 chaîne à l'intérieur de la JSON réponse
Pourquoi Base64?
- JSON-codage sûr pour les données binaires
- Facile à transmettre sur HTTP
- Compatible avec tous les langages de programmation
- Peut être directement intégré dans JSON sans échapper aux problèmes
Décodage Base64 vers un document Word :
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes("output.docx", wordBytes);
Exemples de suppression de page
Comprendre les différents modèles de suppression de pages :
| Pages du document | startPage | endPage | Numéros de page | Résultat |
|---|---|---|---|---|
| 1, 2, 3, 4, 5 | 2 | 4 | - | Conserve : 1,5 |
| 1, 2, 3, 4, 5 | 3 | - | - | Conserve : 1,2 |
| 1, 2, 3, 4, 5 | - | - | "2,4" | Conserve : 1, 3, 5 |
| 1, 2, 3, 4, 5 | 2 | 3 | "5" | Conserve : 1,4 |
Exemple de requête
En-tête
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Note:
- Obtenez votre API clé de la PDF4me Tableau de bord
- Le API La clé doit être Base64 encodé et préfixé par « Basic » dans le Authorization en-tête
- Exemple : Si votre API La clé est
abc123, encodez-le en Base64 et utiliserAuthorization: Basic YWJjMTIz
Charge utile
Exemple de base (suppression de plage) :
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
Exemple de pages spécifiques :
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
Exemple avancé (suppression combinée) :
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
Exemples de code
Le PDF4me Supprimer des pages de Word REST API propose des exemples de code dans plusieurs langages de programmation. Choisissez le langage qui convient le mieux à votre environnement de développement :
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# Exemple (CSharp)
Complet C# Implémentation pour la suppression de pages dans les documents Word :
Java Échantillon
Java implémentation avec gestion complète des erreurs et traitement des réponses :
JavaScript Échantillon
Node.js et compatible avec les navigateurs JavaScript mise en œuvre:
Python Échantillon
Python implémentation avec la bibliothèque requests et JSON manutention:
Google Script Échantillon
Google Apps Script mise en œuvre pour Google Workspace intégration :
Cas d'utilisation et applications industrielles
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
Cas d'utilisation des services juridiques et professionnels
- Nettoyage contractuelSupprimer les pages de signature et les annexes des exemplaires du contrat
- Préparation de documents juridiquesSupprimer les pages confidentielles avant leur distribution aux clients
- Optimisation des procédures de dépôt de documents judiciaires: Supprimer les pages inutiles pour respecter les exigences de classement
- Versions des documents clients: Créez des versions propres en supprimant les notes internes
Cas d'utilisation en entreprise
- Optimisation des propositionsSupprimer les pages de coûts internes des propositions aux clients
- Nettoyage des supports marketingSupprimer les pages de contenu obsolètes des documents actuels
- Préparation de la présentationSupprimer les diapositives et notes de sauvegarde des présentations finales
- Optimisation des livrables clients: Créez des versions propres en supprimant les références internes
Cas d'utilisation dans le domaine de l'éducation et de la recherche
- Nettoyage de rapports médicauxSupprimer les pages contenant des informations sensibles sur les patients
- Optimisation des documents de rechercheSupprimer les données préliminaires des rapports finaux
- Préparation des documents de protocole: Supprimer les pages de révision interne des protocoles publiés
- Documentation de conformité: Nettoyer les documents en vue des soumissions réglementaires
Cas d'utilisation dans le secteur financier et bancaire
- Nettoyage des rapports financiers: Supprimer les annexes détaillées des résumés
- Optimisation des documents budgétaires: Supprimer les pages de données historiques des budgets actuels
- Préparation du rapport d'auditSupprimer les pages internes sensibles avant leur diffusion externe
- Nettoyage des dossiers réglementairesOptimiser les documents pour répondre aux exigences de soumission