Passa al contenuto principale

Unione documenti - Assemblaggio documenti API

PDF4me Unisci documenti consente di combinare più documenti Word in un unico documento con opzioni di formattazione e conformità avanzate. Questo API Il servizio elabora più file Word e li unisce con un ordinamento flessibile dei documenti, modalità di formattazione personalizzabili, impostazioni del livello di conformità, metadati del fuso orario e gestione intelligente dello stile. API riceve il contenuto del documento tramite REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Grazie al supporto per l'unione illimitata di documenti e al controllo completo sul comportamento di unione, questa soluzione è ideale per l'assemblaggio di documenti, il consolidamento di report e i flussi di lavoro di gestione dei contenuti.

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.

Caratteristiche principali

  • Supporto per più documenti: Unisci un numero illimitato di documenti in uno solo
  • Struttura semplice dell'array: Serie di facile utilizzo Base64-contenuto del documento codificato
  • Unione ordinata: I documenti sono uniti nell'ordine in cui appaiono nell'array
  • Concetto di documento di base: Il primo documento diventa la base per la fusione
  • Supporto per più formati: Unisci documenti Word, PDF e altri formati supportati

REST API Punto finale

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

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

REST API Parametri

Elenco completo dei parametri per l'unione dei documenti REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.

Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. Documenti L'array deve contenere almeno un documento.

Parametri richiesti

ParametroTipoDescrizioneEsempio
Documenti*ArrayArray di oggetti documento da unire. Deve contenere almeno un documento. Ogni oggetto deve avere nome file (stringa) e docContent Base64 stringa). I documenti vengono uniti nell'ordine in cui appaiono nell'array. Campi opzionali per documento: posizione di ordinamento (intero), modalità formato (corda)[{ "filename": "doc1.docx", "docContent": "base64..." }, { "filename": "doc2.docx", "docContent": "base64..." }]

Parametri opzionali

ParametroTipoDescrizioneEsempio
opzioni di unioneObjectOpzioni di unione (formattazione, conformità, ecc.). Consultare il modello del plugin per le proprietà disponibili.{}

Ordine di unione dei documenti

I documenti vengono uniti nell'ordine in cui appaiono nel Documenti vettore:

  • Il primo documento nell'array diventa il documento base
  • Tutti i documenti successivi sono allegato al documento base in ordine di array

Produzione

IL PDF4me Unisci documenti REST API restituisce risposte diverse a seconda della modalità di elaborazione. API restituisce il documento Word come un Base64-stringa codificata in JSON formato, non come dati binari.

Elaborazione sincrona (impostazione predefinita)

IL API elabora la richiesta e restituisce:

Codice di stato: 200 OK

Tipo di contenuto: application/json

Corpo della risposta:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "merged-document.docx",
"success": true,
"errorMessage": null
}

Campi di risposta:

  • documento (stringa): Il documento Word unito contenente tutti i documenti di input, codificato come Base64 corda
  • Nome file (stringa): Il nome del file Word di output
  • successo (booleano): Indica se la richiesta è andata a buon fine
  • messaggio di errore (stringa 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. Salva o elabora il file Word secondo necessità.

Esempio (JavaScript):

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

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 di base (due documenti):

{
"documents": [
{ "filename": "doc1.docx", "docContent": "base64EncodedDocument1" },
{ "filename": "doc2.docx", "docContent": "base64EncodedDocument2" }
]
}

Esempio avanzato (più documenti con opzioni di unione):

{
"documents": [
{ "filename": "doc1.docx", "docContent": "base64EncodedDocument1" },
{ "filename": "doc2.docx", "docContent": "base64EncodedDocument2" },
{ "filename": "doc3.docx", "docContent": "base64EncodedDocument3" }
],
"mergeOptions": {}
}

Esempi di codice

IL PDF4me Unisci documenti 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 l'unione di documenti Word:

Casi d'uso e applicazioni industriali

Casi d'uso per servizi legali e professionali

  • Assemblaggio a contratto: Unire le sezioni del contratto in documenti legali completi
  • Consolidamento di memorie legali: Unire più sezioni di brevi documenti in memorie legali complete
  • Documentazione di conformità: Consolidare i documenti di conformità per le presentazioni normative
  • Assemblaggio della documentazione del cliente: Unire i documenti specifici del cliente in pacchetti completi

Richiedi assistenza