Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Division du document - Division du document API

PDF4me Document fractionné permet de diviser les documents Word en plusieurs documents plus petits grâce à des options de fractionnement flexibles et à un contrôle de configuration complet. API Ce service traite les fichiers Word et les divise par pages, sections, titres ou plages de pages personnalisées, avec un contrôle total sur les critères de division, le nommage des documents et l'organisation de la sortie. 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 du fractionnement par page, de la division par section, de la séparation par titre et des plages de pages personnalisées, cette solution est idéale pour la gestion documentaire, la distribution de contenu et l'automatisation des flux de travail.

Articles de blog connexes
Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.
En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.
Consultez le blog →

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.

Get your api Key

Caractéristiques principales​

  • Types de division multiples: Diviser par pages, sections, titres ou plages personnalisées
  • Prise en charge des plages de pages: Fractionner en fonction de numéros de page ou de plages spécifiques
  • Division par sectionsDivisez le document après chaque section Word.
  • Division basée sur les titres: Diviser le document après chaque titre du style spécifié (par exemple, Titre 1, Titre 2)
  • Configuration flexible: Critères de fractionnement personnalisés avec le paramètre splitConfig
  • Noms uniques de documentsChaque document divisé reçoit un nom de fichier GUID unique.
  • Préservation du format: Conserve la mise en forme et la structure originales du document
  • 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 fractionnement de documents sont effectuées via un point de terminaison unique :

  • Méthode: POST
  • Point final : office/ApiV2Word/SplitDocument

REST API Paramètres​

Liste complète des paramètres pour le document fractionné 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. splitConfig le paramètre est requis lorsque splitType est « tableau », « nombre de pages » ou « titres ».

Paramètres requis​

ParamètreTaperDescriptionExemple
document*ObjectRéférence du document. Doit contenir Nom (stringNom de fichier Word avec l'extension .docx. Utilisé pour la référence et le traitement.{ "Name": "document.docx" }
docContent*Base64Contenu du document Word encodé en Base64Le document est divisé selon des critères spécifiés. Il doit s'agir d'un document Word valide (formats .docx ou .doc).base64EncodedDocumentContent

Paramètres optionnels​

ParamètreTaperDescriptionExemple
splitTypeStringType de fractionnement de document. Options : allpages - Diviser en pages individuelles (par défaut), array - Séparer par plages de pages explicites (par exemple « 1-3,4,5-7 »), numberofpages - Division après chaque N pages (configuration : entier positif comme « 3 » ou « 5 »), section - Divisez le document après chaque section, headings - Divisez le document après chaque titre du style spécifié (par exemple, « Titre 1 »). Chaque document divisé reçoit un identifiant unique. GUID nom de fichier"allpages"
splitConfigStringConfiguration pour le fractionnement. Pour le tableau: Plages de pages comme « 1-3,4,5-7 » (pages 1-3, page 4, pages 5-7) ou pages individuelles « 1,3,5 ». Pour le nombre de pages: Un entier positif comme « 3 » ou « 5 » : divisions après chaque N pages. Pour les titresNom du style de titre, par exemple « Titre 1 » ou « Titre 2 ». Obligatoire lorsque splitType est « array », « numberofpages » ou « headings ». La numérotation des pages commence à 1. La correspondance des titres ne tient pas compte de la casse."1-3,4,5-7" ou "3" ou "Heading 1"
nom de la cultureStringCode de culture pour le traitement des documents (par exemple, « en-US », « de-DE », « fr-FR »). Par défaut : « en-US ». Affecte la langue et la mise en forme du document. Utilisé pour la gestion des métadonnées et de la localisation.en-US

Options de type split​

Le API propose différents types de division pour les documents :

Type diviséDescriptionNécessite splitConfigCas d'utilisation
allpagesDiviser en pages individuelles (par défaut)NonExtraire chaque page comme un document séparé
arraySéparation par plages de pages explicites. Chaque plage séparée par des virgules devient un document (par exemple, « 1-3,4,5-7 » → 3 documents).OuiCréez des documents à partir de plages de pages spécifiques ou de pages individuelles
numberofpagesDivision séquentielle : chaque groupe de N pages forme un document ; le reste constitue le dernier document.OuiDivisez en morceaux de taille égale (par exemple toutes les 3 ou 5 pages).
sectionDivisez le document après chaque section WordNonUn document par section
headingsDivisez le document après chaque titre du style spécifié (par exemple « Titre 1 »).OuiExtraire les chapitres ou les parties par niveau de titre

Exemples de configuration fractionnée​

Comprendre la configuration de fractionnement permet d'optimiser vos flux de travail de fractionnement de documents :

array: plages de pages explicites​

  • "1-3,4,5-7" → 3 documents : pages 1 à 3, page 4, pages 5 à 7
  • "1,3,5" → 3 documents : page 1, page 3, page 5
  • "1-5,6-10" → 2 documents : pages 1-5, pages 6-10

numberofpages: division après chaque N pages​

Comportement: Division séquentielle après chaque N pages. Configuration : Obligatoire, le format est un seul entier positif (par exemple, "3", "5").

Exemples :

  • Configuration "3" Sur un document de 10 pages → 4 documents :

    Document 1 : pages 1 à 3, Document 2 : pages 4 à 6, Document 3 : pages 7 à 9, Document 4 : page 10

  • Configuration "5" Sur un document de 12 pages → 3 documents :

    Document 1 : pages 1 à 5, Document 2 : pages 6 à 10, Document 3 : pages 11 et 12

headings: séparation après chaque titre​

  • "Heading 1", un document par bloc qui se termine au prochain titre de niveau 1 (ou à la fin du document)
  • "Heading 2", un document par bloc qui se termine au prochain titre de niveau 2 (ou à la fin du document)
  • Appariement insensible à la casse

section​

Aucune configuration requise. Le document est divisé après chaque saut de section Word ; chaque section devient un document distinct.

Sortir​

Le PDF4me Document fractionné REST API renvoie le résultat de la division sous forme de JSON. Le API renvoie un seul document dans la réponse (le premier document divisé), avec des champs de réponse standard.

Traitement synchrone (par défaut)

Le API traite la requête et renvoie le premier document fractionné :

Code d'état : 200 OK

Type de contenu : application/json

Corps de la réponse :

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "a1b2c3d4-e5f6-7890-abcd-ef1234567890.docx",
"success": true,
"errorMessage": null
}

Champs de réponse :

  • document (string): Le contenu du premier document divisé, encodé comme Base64 chaîne
  • nom de fichier (string): Nom de fichier généré pour le document divisé (GUID-basé)
  • succès (boolean): Indique si la requête a abouti
  • message d'erreur (string ou null) : Détails de l’erreur en cas de succès faux

Mode d'emploi :

  1. Extraire le document champ du JSON réponse (Base64)
  2. Décodez le Base64 chaîne permettant d'obtenir les données binaires d'un document Word
  3. Utilisez le fileName pour enregistrer le document divisé

Exemple (JavaScript) :

const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save with data.fileName or custom name

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 utiliser Authorization: Basic YWJjMTIz

Charge utile​

Exemple de base (Fractionner toutes les pages - Par défaut) :

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "allpages"
}

Exemple de plage de pages (tableau) :

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "array",
 "splitConfig": "1-3,4,5-7"
}

Exemple de fractionnement après chaque N pages (nombre de pages) :

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "numberofpages",
 "splitConfig": "3"
}

Exemple basé sur les titres (séparation après chaque titre) :

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "headings",
 "splitConfig": "Heading 1",
 "cultureName": "en-US"
}

Exemple structuré par sections (séparation après chaque section) :

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "section",
 "cultureName": "en-US"
}

Exemples de code​

Le PDF4me Document fractionné 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# (CSharp) Échantillon

Complet C# implémentation pour la division des documents Word :

Cas d'utilisation et applications industrielles​

Cas d'utilisation des services juridiques et professionnels

  • Gestion des contratsDiviser les contrats multipartites en sections individuelles
  • Documentation du dossierExtraire des pages spécifiques des dossiers judiciaires
  • Rapports de conformitéRépartir les sections pertinentes entre les différents départements
  • Recherche juridiqueDivisez les documents juridiques volumineux par sujet ou section.

Obtenez de l'aide​

Get Your API KeyAPI SamplesGetting Started