Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Combinar documentos - Ensamblaje de documentos API

PDF4me Combinar documentos Le permite combinar varios documentos de Word en un solo documento con opciones avanzadas de formato y cumplimiento. API El servicio procesa varios archivos de Word y los combina con un ordenamiento flexible de documentos, modos de formato personalizables, configuraciones de nivel de cumplimiento, metadatos de zona horaria y manejo inteligente de estilos. API recibe el contenido del documento a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Con soporte para la fusión ilimitada de documentos y control total sobre el comportamiento de la fusión, esta solución es ideal para flujos de trabajo de ensamblaje de documentos, consolidación de informes y gestión de contenido.

Entradas de blog relacionadas
Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.
Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.
Visita el blog →

Autenticando su API Pedido​

Para acceder al PDF4me REST APICada solicitud debe incluir las credenciales de autenticación adecuadas. La autenticación garantiza una comunicación segura y valida su identidad como usuario autorizado del sistema. REST API.

Get your api Key

Características principales​

  • Compatibilidad con múltiples documentos: Combinar un número ilimitado de documentos en uno solo
  • Estructura de matriz simple: Matriz de fácil uso de Base64-contenido del documento codificado
  • Fusión ordenada: Documentos fusionados en el orden en que aparecen en la matriz
  • Concepto del documento base: El primer documento se convierte en la base para la fusión
  • Compatibilidad con múltiples formatos: Combinar documentos de Word, PDF y otros formatos compatibles.

REST API Punto final​

El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones de fusión de documentos se realizan a través de un único punto final:

  • Método: POST
  • Punto final: office/ApiV2Word/MergeDocuments

REST API Parámetros​

Lista completa de parámetros para la combinación de documentos REST APILos parámetros están organizados por categoría para una mejor comprensión e implementación.

Importante: Los parámetros marcados con un asterisco (*) son obligatorios. documentos El array debe contener al menos un documento.

Parámetros requeridos​

ParámetroTipoDescripciónEjemplo
documentos*ArrayMatriz de objetos de documento que se fusionarán. Debe contener al menos un documento. Cada objeto debe tener Nombre del archivo (cadena) y docContent (Base64 cadena). Los documentos se fusionan en el orden en que aparecen en la matriz. Campos opcionales por documento: ordenarPosición (entero), modo de formato (cadena)[{ "filename": "doc1.docx", "docContent": "base64..." }, { "filename": "doc2.docx", "docContent": "base64..." }]

Parámetros opcionales​

ParámetroTipoDescripciónEjemplo
opciones de fusiónObjectOpciones de fusión (formato, conformidad, etc.). Consulte el modelo del complemento para ver las propiedades disponibles.{}

Orden de fusión de documentos​

Los documentos se fusionan en el orden en que aparecen en el documentos matriz:

  • El primer documento en la matriz se convierte en el documento base
  • Todos los documentos subsiguientes son adjunto al documento base en orden de matriz

Producción​

El PDF4me Combinar documentos REST API devuelve diferentes respuestas según el modo de procesamiento. API devuelve el documento de Word como un Base64cadena codificada en JSON formato, no como datos binarios.

Procesamiento síncrono (predeterminado)

El API procesa la solicitud y devuelve:

Código de estado: 200 OK

Tipo de contenido: application/json

Cuerpo de la respuesta:

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

Campos de respuesta:

  • documento (cadena): El documento de Word combinado que contiene todos los documentos de entrada, codificado como Base64 cadena
  • Nombre del archivo (cadena): El nombre del archivo Word de salida
  • éxito (booleano): Indica si la solicitud se realizó correctamente.
  • mensaje de error (cadena o nulo): Detalles del error cuando el éxito es falso.

Cómo usarlo:

  1. Extraer el document campo del JSON respuesta (Base64)
  2. Decodifica el Base64 cadena para obtener los datos binarios del documento de Word
  3. Guarde o procese el archivo de Word según sea necesario.

Ejemplo (JavaScript):

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

Ejemplo de solicitud​

Encabezamiento​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

  • Consigue tu API clave del PDF4me Panel
  • El API La clave debe ser Base64 codificado y prefijado con "Basic" en el Authorization encabezado
  • Ejemplo: Si su API La clave es abc123, codificarlo a Base64 y usar Authorization: Basic YWJjMTIz

Carga útil​

Ejemplo básico (dos documentos):

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

Ejemplo avanzado (varios documentos con opciones de combinación):

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

Ejemplos de código​

El PDF4me Combinar documentos REST API Proporciona ejemplos de código en varios lenguajes de programación. Elija el lenguaje que mejor se adapte a su entorno de desarrollo:

C# (CSharp) Muestra

Completo C# Implementación para combinar documentos de Word:

Casos de uso y aplicaciones en la industria​

Casos de uso de servicios legales y profesionales

  • Ensamblaje de contratos: Combinar secciones de contratos en documentos legales completos
  • Consolidación de informes legales: Combinar varias secciones breves en informes legales completos.
  • Documentación de cumplimiento: Consolidar los documentos de cumplimiento para las presentaciones regulatorias.
  • Recopilación de documentos del cliente: Combinar documentos específicos del cliente en paquetes completos

Obtén ayuda​

Get Your API KeyAPI SamplesGetting Started