Mesclar várias opções PDF Arquivos

PDF4me Fusão é um REST ponto final que combina múltiplos PDFs em um único documento. POST uma variedade de Base64-arquivos codificados para /api/v2/Merge com um nome de saída e o API anexa-os na ordem do array e retorna o resultado mesclado. PDF como bytes brutos. Defina async Verdadeiro para grandes lotes e pesquisas. Location URL até que o resultado esteja pronto.

O que este endpoint faz

São necessários dois ou mais PDFs e retorna um único arquivo: fatura com anexos, capa com relatório e uma pasta com as digitalizações consolidadas em um único arquivo. A ordem do array corresponde à ordem das páginas, portanto, seu código controla totalmente o resultado. Este é o endpoint de concatenação simples; sobreposição pages Sobrepor-se uma à outra é uma ação separada (Mesclar Sobreposição).

Autenticando seu API Solicitar

Todo PDF4me REST A chamada deve incluir o seu API chave no Authorization Defina o cabeçalho como autenticação básica. Obtenha ou altere sua chave no painel do desenvolvedor.

Get your API Key

Ponto final

POST/api/v2/Mesclar

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

Fatos importantes que você não deve perder

docContent é uma matriz, e a ordem importa

Ao contrário da maioria PDF4me pontos finais onde docContent é uma única string, aqui é um ARRAY de Base64 strings. A ordem do array é a ordem de mesclagem; não há parâmetro de ordenação separado.

Uma resposta de 200 é a PDF em si

O corpo é puramente binário, não um JSON wrapper. Escreva os bytes diretamente em um .pdf arquivo. JSON-analisar a resposta ou Base64-Decodificar isso corrompe a saída.

assíncrono verdadeiro para lotes grandes

Com "assíncrono": verdadeiro o API respostas 202 Accepted com um Location cabeçalho. Consulte-o com GET aproximadamente a cada 10 segundos (as amostras oficiais usam intervalos de 10 segundos, até 20 tentativas) até que o código 200 retorne o arquivo mesclado.

HTTP configurar

Método: POST
URL: https://api.pdf4me.com/api/v2/Merge
Tipo de conteúdo: aplicativo/json
Authorization: Básico <seu PDF4me API chave>

O corpo da resposta 200 é a resposta mesclada. PDF como bytes brutos: salve diretamente. Uma resposta 202 significa que a mesclagem está sendo executada de forma assíncrona: consulte o Location URL até 200.

Quais são as diferenças entre o processamento síncrono e o assíncrono?

O async A flag altera o contrato de resposta, não o resultado da mesclagem. Selecione pelo tamanho do lote.

Síncrono vs. assíncrono	`"async": false` (padrão)	`"async": true`
Resposta sobre success	200 com a fusão PDF como bytes brutos	202 Accepted com um `Location` votação URL
Conexão	A tela permanecerá aberta até a conclusão da mesclagem.	Devoluções imediatas
Como obter o arquivo	Salvar o corpo da resposta diretamente	GET o Location URL a cada ~10 segundos até que responda com o código 200 e os bytes.
Ideal para	Alguns arquivos pequenos	Grandes lotes e documentos grandes

API campos corporais

Parâmetro	Obrigatório	Tipo	O que faz	Exemplo
`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`

Exemplos de cargas úteis

Mesclar dois PDFs sincronicamente

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

Mesclar um lote grande de forma assíncrona

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

Dicas de coleta do carteiro

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.

exemplo 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

O que significa o API retornar?

Campo	Tipo	O que contém
`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.

Exemplos de código

Exemplos oficiais e executáveis para este endpoint específico, por language:

Perguntas frequentes

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 que fazer uma fusão? PDFs via API Em vez de uma ferramenta para desktop?

As ferramentas de mesclagem para desktop e web são adequadas para tarefas pontuais, mas exigem intervenção humana para selecionar os arquivos, organizá-los na ordem correta e baixar o resultado. API Faz a mesma concatenação que uma solicitação determinística por lote, com a ordem definida pelo seu código em vez de por arrastar e soltar. A saída é um padrão. PDF em conformidade com o ISO Especificação 32000Assim, o arquivo abre em qualquer leitor e alimenta o próximo passo do pipeline sem problemas, seja ele de compressão, OCRou assinatura eletrônica.