Combinar varios PDF Archivos

PDF4me Fusionar es un REST punto final que combina múltiples PDFs en un solo documento. POST una variedad de Base64archivos codificados a /api/v2/Merge con un nombre de salida y el API los agrega en orden de matriz y devuelve el combinado. PDF como bytes sin procesar. Establecer async verdadero para lotes grandes y encuestar el Location URL hasta que el resultado esté listo.

Lo que hace este punto final

Se necesitan dos o más PDFs y devuelve uno: factura más archivos adjuntos, página de portada más informe, una carpeta de escaneos consolidados en un solo archivo. El orden de la matriz es el orden de la página, por lo que su código controla completamente el resultado. Este es el punto final de concatenación simple; superponiendo pages La superposición de ambas acciones constituye una acción independiente (Superposición de fusión).

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

Cada PDF4me REST La llamada debe incluir su API clave en el Authorization Encabezado como autenticación básica. Obtenga o cambie su clave desde el panel de desarrollador.

Get your API Key

Punto final

POST/api/v2/Fusionar

cartero URLhttps://api.pdf4me.com/api/v2/Merge

Datos importantes que no debes perderte

docContent es una matriz, y el orden importa

A diferencia de la mayoría PDF4me puntos finales donde docContent es una sola cadena, aquí es una MATRIZ de Base64 cadenas. El orden de la matriz es el orden de fusión; no hay ningún parámetro de ordenación separado.

Una respuesta de 200 es la PDF La misma

El cuerpo es binario puro, no un JSON envoltorio. Escribe los bytes directamente en un .pdf archivo. JSON-analizar la respuesta o Base64-descifrarlo corrompe el resultado.

asíncrono verdadero para lotes grandes

Con "asíncrono": verdadero el API respuestas 202 Accepted con un Location encabezado. Sondéelo con GET aproximadamente cada 10 segundos (las muestras oficiales usan intervalos de 10 segundos, hasta 20 reintentos) hasta que 200 devuelva el archivo fusionado.

HTTP configuración

Método: POST
URL: https://api.pdf4me.com/api/v2/Merge
Tipo de contenido: aplicación/json
Authorization: Básico <tu PDF4me API clave>

Un cuerpo de respuesta de 200 es el fusionado PDF como bytes sin procesar: guárdelo directamente. Una respuesta 202 significa que la fusión se está ejecutando de forma asíncrona: sondee el Location URL hasta 200.

¿En qué se diferencian el procesamiento síncrono y el asíncrono?

El async El indicador modifica el contrato de respuesta, no el resultado de la fusión. Seleccione según el tamaño del lote.

Síncrono vs. asíncrono	`"async": false` (por defecto)	`"async": true`
Respuesta sobre success	200 con la fusión PDF como bytes sin procesar	202 Accepted con un `Location` encuestas URL
Conexión	Permanecerá abierto hasta que finalice la fusión.	Devuelve el dinero inmediatamente.
Cómo obtener el archivo	Guarda el cuerpo de la respuesta directamente	GET el Location URL cada ~10 segundos hasta que responda 200 con los bytes
Lo mejor para	Unos pocos archivos pequeños	Lotes grandes y documentos de gran tamaño

API campos corporales

Parámetro	Requerido	Tipo	Lo que hace	Ejemplo
`docContent`	Required	array of strings	An array of Base64-encoded PDF files, at least two entries. The array order is the merge order of the output document.	`["JVBERi0x...", "JVBERi0x..."]`
`docName`	Required	string	Output filename for the merged PDF.	`merged.pdf`
`async`	Optional	boolean	false (default) returns the merged PDF directly on 200. true returns 202 plus a Location URL to poll, for large batches.	`true`

Cargas útiles de ejemplo

Fusionar dos PDFs sincrónicamente

{
 "docContent": [
 "JVBERi0xLjcKJb...first PDF Base64...",
 "JVBERi0xLjcKJb...second PDF Base64..."
 ],
 "docName": "merged.pdf"
}

Combinar un lote grande de forma asíncrona

{
 "docContent": [
 "JVBERi0x...cover...",
 "JVBERi0x...report...",
 "JVBERi0x...appendix-a...",
 "JVBERi0x...appendix-b..."
 ],
 "docName": "quarterly-pack.pdf",
 "async": true
}

Consejos para el cobro de carteros

Headers

Content-Type: application/json + Authorization: Basic <apiKey>.

Body

raw JSON. docContent is an ARRAY of Base64 strings, one per source PDF, in merge order.

Response

On 200, switch Postman to "Send and Download": the body is the PDF itself, not JSON.

Async

With async true, copy the Location header from the 202 response into a GET request and poll it until 200.

Ejemplo de curl

curl -X POST https://api.pdf4me.com/api/v2/Merge \
 -H "Content-Type: application/json" \
 -H "Authorization: Basic YOUR_API_KEY" \
 -d '{
 "docContent": [
 "'"$(base64 -w 0 first.pdf)"'",
 "'"$(base64 -w 0 second.pdf)"'"
 ],
 "docName": "merged.pdf"
 }' \
 --output merged.pdf

¿Qué significa el API ¿devolver?

Campo	Tipo	Lo que contiene
`200 response body`	Binary (application/pdf)	The merged PDF file itself as raw bytes. Save it directly to disk; do not JSON-parse or Base64-decode.
`202 Location header`	URL	Async mode only: the polling URL. GET it about every 10 seconds until it returns 200 with the merged PDF bytes.
`4xx/5xx response body`	JSON or text	Error details: 400 for malformed Base64 or a bad payload shape, 401 for a missing or invalid API key, 500 for server-side processing failures.

Ejemplos de código

Muestras oficiales y ejecutables para este punto final exacto, por language:

Preguntas frecuentes

How is the merge order decided?+

By the docContent array order. The first Base64 string becomes the first pages of the output, the second is appended after it, and so on. Reorder the array to reorder the merged document.

Is the response JSON with a Base64 file inside?+

No. A 200 response body is the merged PDF itself as raw binary bytes. Write response.content straight to a .pdf file; do not JSON-parse or Base64-decode it.

When should I set async to true?+

For large batches or big files. With async true the API returns 202 Accepted plus a Location header; poll that URL with GET requests about every 10 seconds until it returns 200 with the merged PDF.

Can I merge Word or Excel files with this endpoint?+

No. /api/v2/Merge accepts PDFs only. Merge Word files with the Merge Documents Word endpoint, or convert other formats to PDF first and then merge the results here.

How many PDFs can I merge in one call?+

The docContent array accepts multiple documents in a single request; two entries is the minimum meaningful merge. For very large batches, set async true so the merge runs server-side while you poll for the result.

What is the difference between Merge and Merge Overlay?+

Merge appends documents one after another, page by page. Merge Overlay stamps the pages of one PDF on top of the pages of another, which is what you want for letterheads and backgrounds.

Why am I getting a 400 Bad Request?+

The usual causes are a docContent that is a single string instead of an array, an entry that is not valid Base64, or a source file that is not actually a PDF. Encode each file separately and keep the array shape.

¿Por qué fusionarse? PDFs a través de API ¿En lugar de una herramienta de escritorio?

Las herramientas de combinación de escritorio y web son adecuadas para trabajos puntuales, pero requieren que una persona seleccione los archivos, los arrastre para ordenarlos y descargue el resultado. API Realiza la misma concatenación que una solicitud determinista por lote, con el orden fijado por su código en lugar de por arrastrar y soltar. La salida es un estándar PDF conforme a la ISO Especificación 32000, de modo que se abre en cualquier lector y se introduce limpiamente en el siguiente paso de la cadena, ya sea la compresión, OCRo firma electrónica.