Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Dividi documento - Divisione del documento API

PDF4me Dividi il documento consente di dividere i documenti Word in più documenti più piccoli con opzioni di suddivisione flessibili e un controllo completo della configurazione. API Il servizio elabora i file Word e li suddivide per pagine, sezioni, intestazioni o intervalli di pagine personalizzati con il pieno controllo sui criteri di suddivisione, la denominazione dei documenti e l'organizzazione dell'output. API riceve il contenuto del documento Word tramite REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Grazie al supporto per la suddivisione in pagine, sezioni, intestazioni e intervalli di pagine personalizzati, questa soluzione è ideale per la gestione dei documenti, la distribuzione dei contenuti e l'automazione dei flussi di lavoro.

Articoli correlati del blog
Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.
Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.
Visita il blog →

Autenticazione del tuo API Richiesta​

Per accedere al PDF4me REST API, ogni richiesta deve includere credenziali di autenticazione adeguate. L'autenticazione garantisce una comunicazione sicura e convalida la tua identità come utente autorizzato del REST API.

Get your api Key

Caratteristiche principali​

  • Diversi tipi di splitSuddivisione per pagine, sezioni, intestazioni o intervalli personalizzati
  • Supporto per intervalli di pagineSuddivisione in base a numeri di pagina o intervalli specifici
  • Suddivisione in sezioni: Dividi il documento dopo ogni sezione di Word
  • Divisione basata sulla voce: Dividi il documento dopo ogni intestazione dello stile specificato (ad esempio, Intestazione 1, Intestazione 2)
  • Configurazione flessibile: Criteri di suddivisione personalizzati con parametro splitConfig
  • Nomi univoci dei documentiOgni documento suddiviso riceve un nome file GUID univoco
  • Conservazione del formatoMantiene la formattazione e la struttura originali del documento.
  • Supporto culturaleElaborazione dei documenti specifici per la località

REST API Punto finale​

IL PDF4me REST API utilizza standard HTTP Metodi per interagire con le risorse. Tutte le operazioni di suddivisione dei documenti vengono eseguite tramite un unico endpoint:

  • Metodo: POST
  • Punto finale: office/ApiV2Word/SplitDocument

REST API Parametri​

Elenco completo dei parametri per la divisione del documento REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.

Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. splitConfig il parametro è richiesto quando splitType è "array", "numberofpages" o "headings".

Parametri richiesti​

ParametroTipoDescrizioneEsempio
documento*ObjectRiferimento al documento. Deve contenere Nome string): Nome del file Word con estensione .docx. Utilizzato per riferimento ed elaborazione{ "Name": "document.docx" }
docContent*Base64Il contenuto del documento Word codificato in Base64Il documento viene suddiviso in base a criteri specifici. Deve essere un documento Word valido (formati .docx, .doc).base64EncodedDocumentContent

Parametri opzionali​

ParametroTipoDescrizioneEsempio
splitTypeStringTipo di suddivisione del documento. Opzioni: allpages - Dividi in singole pagine (impostazione predefinita), array - Suddivisione in base a intervalli di pagine espliciti (ad esempio "1-3,4,5-7"), numberofpages - Dividi dopo ogni N pagine (configurazione: numero intero positivo come "3" o "5"), section - Dividi il documento dopo ogni sezione, headings - Dividi il documento dopo ogni intestazione dello stile specificato (ad esempio "Intestazione 1"). Ogni documento diviso ottiene un identificativo univoco GUID nomefile"allpages"
splitConfigStringConfigurazione per la suddivisione. Per array: Intervalli di pagine come "1-3,4,5-7" (pagine 1-3, pagina 4, pagine 5-7) o singole pagine "1,3,5". Per numero di pagine: Un numero intero positivo come "3" o "5" : divide dopo ogni N pagine. Per le intestazioniNome dello stile di intestazione, ad esempio "Intestazione 1" o "Intestazione 2". Obbligatorio quando splitType è "array", "numberofpages" o "headings". La numerazione delle pagine è basata su 1. La corrispondenza delle intestazioni non fa distinzione tra maiuscole e minuscole."1-3,4,5-7" O "3" O "Heading 1"
Nome della culturaStringCodice cultura per l'elaborazione dei documenti (ad es. "en-US", "de-DE", "fr-FR"). Predefinito: "en-US". Influisce sulla lingua e sulla formattazione del documento. Utilizzato per la gestione dei metadati e della localizzazione.en-US

Opzioni di tipo split​

IL API offre diversi tipi di suddivisione per la divisione del documento:

Tipo divisoDescrizioneRichiede splitConfigCaso d'uso
allpagesDividi in pagine individuali (impostazione predefinita)NOEstrai ogni pagina come documento separato
arraySuddivisione in base a intervalli di pagine espliciti. Ogni intervallo separato da virgole diventa un documento (ad esempio, "1-3,4,5-7" → 3 documenti).SÌCrea documenti a partire da intervalli di pagine specifici o da singole pagine.
numberofpagesSuddivisione dopo ogni N pagine. Suddivisione sequenziale: ogni N pagine formano un documento; la parte rimanente è l'ultimo documento.SÌSuddividere in sezioni di uguale lunghezza (ad esempio, ogni 3 o 5 pagine)
sectionDividi il documento dopo ogni sezione di WordNOUn documento per sezione
headingsDividi il documento dopo ogni intestazione dello stile specificato (ad esempio, "Intestazione 1").SÌEstrarre capitoli o parti per livello di intestazione

Esempi di configurazione divisa​

Comprendere la configurazione della divisione dei documenti aiuta a ottimizzare i flussi di lavoro relativi a questa operazione:

array: intervalli di pagine espliciti​

  • "1-3,4,5-7" → 3 documenti: pagine 1-3, pagina 4, pagine 5-7
  • "1,3,5" → 3 documenti: pagina 1, pagina 3, pagina 5
  • "1-5,6-10" → 2 documenti: pagine 1-5, pagine 6-10

numberofpages: suddivisione dopo ogni N pagine​

Comportamento: Suddivide sequenzialmente dopo ogni N pagine. Configurazione: Obbligatorio, il formato è un singolo numero intero positivo (ad esempio "3", "5").

Esempi:

  • Configurazione "3" Su un documento di 10 pagine → 4 documenti: Documento 1: pagine 1-3, Documento 2: pagine 4-6, Documento 3: pagine 7-9, Documento 4: pagina 10
  • Configurazione "5" Su un documento di 12 pagine → 3 documenti: Documento 1: pagine 1-5, Documento 2: pagine 6-10, Documento 3: pagine 11-12

headings: dividere dopo ogni intestazione​

  • "Heading 1", un documento per blocco che termina con il successivo Titolo 1 (o fine documento)
  • "Heading 2", un documento per blocco che termina con il successivo Titolo 2 (o fine del documento)
  • corrispondenza senza distinzione tra maiuscole e minuscole

section​

Non è necessaria alcuna configurazione. Il documento viene suddiviso dopo ogni interruzione di sezione di Word; ogni sezione diventa un documento a sé stante.

Produzione​

IL PDF4me Dividi il documento REST API restituisce il risultato della divisione come JSON. IL API restituisce un singolo documento nella risposta (il primo documento suddiviso), con i campi di risposta standard.

Elaborazione sincrona (impostazione predefinita)

IL API elabora la richiesta e restituisce il primo documento suddiviso:

Codice di stato: 200 OK

Tipo di contenuto: application/json

Corpo della risposta:

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

Campi di risposta:

  • documento string): Il primo contenuto del documento diviso, codificato come Base64 corda
  • Nome file string): Nome file generato per il documento diviso (GUID-basato)
  • successo boolean): Indica se la richiesta è andata a buon fine
  • messaggio di errore string o null): Dettagli dell'errore quando il successo è falso

Come si usa:

  1. Estrarre il document campo dal JSON risposta (Base64)
  2. decodificare il Base64 stringa per ottenere i dati binari del documento Word
  3. Utilizzare il fileName per salvare il documento diviso

Esempio (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

Esempio di richiesta​

Intestazione​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

  • Ottieni il tuo API chiave dalla PDF4me Pannello di controllo
  • IL API la chiave deve essere Base64 codificato e prefissato con "Basic" nel Authorization intestazione
  • Esempio: se il tuo API la chiave è abc123, codificalo in Base64 e utilizzare Authorization: Basic YWJjMTIz

Carico utile​

Esempio base (Dividi tutte le pagine - Impostazione predefinita):

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

Esempio di intervallo di pagine (array):

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

Dividi dopo ogni N pagine Esempio (numero di pagine):

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

Esempio basato su intestazioni (separare dopo ogni intestazione):

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

Esempio basato su sezioni (suddivisione dopo ogni sezione):

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

Esempi di codice​

IL PDF4me Dividi il documento REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:

C# CSharp) Campione

Completo C# implementazione per la divisione di documenti Word:

Casi d'uso e applicazioni industriali​

Casi d'uso per servizi legali e professionali

  • Gestione dei contrattiSuddividere i contratti multipartitici in sezioni individuali
  • Documentazione del caso: Estrarre pagine specifiche dai fascicoli del caso
  • Rapporti di conformitàDistribuire le sezioni pertinenti ai diversi dipartimenti
  • Ricerca giuridicaSuddividere documenti legali di grandi dimensioni per argomento o sezione

Richiedi assistenza​

Get Your API KeyAPI SamplesGetting Started