Fusionner plusieurs PDF Fichiers

PDF4me Fusionner est un REST point de terminaison qui combine plusieurs PDFs en un seul document. POST un ensemble de Base64-fichiers encodés /api/v2/Merge avec un nom de sortie, et le API les concatène dans l'ordre du tableau et renvoie le résultat fusionné. PDF sous forme d'octets bruts. Définir async C'est vrai pour les grands lots et pour le sondage. Location URL jusqu'à ce que le résultat soit prêt.

Que fait ce point de terminaison ?

Il faut deux personnes ou plus PDFs et renvoie un élément : facture et pièces jointes, page de garde et rapport, ou un dossier de numérisations regroupées en un seul fichier. L’ordre du tableau correspond à l’ordre des pages ; votre code contrôle donc entièrement le résultat. Il s’agit du point de terminaison de concaténation simple ; superposition pages superposer les deux est une action distincte (Fusionner la superposition).

Articles de blog connexes

Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.

En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.

Consultez le blog →

Authentification de votre API Demande

Chaque PDF4me REST L'appel doit inclure votre API clé dans le Authorization En-tête : Authentification de base. Récupérez ou renouvelez votre clé depuis le tableau de bord développeur.

Get your API Key

Point de terminaison

POST/api/v2/Fusion

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

Informations importantes à ne pas manquer

docContent est un tableau, et l'ordre compte

Contrairement à la plupart PDF4me points d'extrémité où docContent est une chaîne unique, ici c'est un TABLEAU de Base64 chaînes de caractères. L'ordre du tableau correspond à l'ordre de fusion ; il n'existe pas de paramètre d'ordre distinct.

Une réponse de 200 est PDF lui-même

Le corps est binaire brut, pas un JSON enveloppe. Écrivez les octets directement dans un .pdf déposer. JSON-analyse de la réponse ou Base64-Le décodage corrompt le résultat.

async activé pour les gros lots

Avec "async": vrai le API réponses 202 Accepted avec un Location en-tête. Interrogez-le avec GET environ toutes les 10 secondes (les exemples officiels utilisent des intervalles de 10 secondes, jusqu'à 20 tentatives) jusqu'à ce que 200 renvoie le fichier fusionné.

HTTP installation

Méthode: POST
URL: https://api.pdf4me.com/api/v2/Merge
Type de contenu : application/json
Authorization: Basique <votre PDF4me API clé>

Un corps de réponse de 200 personnes est le corps fusionné PDF Sous forme d'octets bruts : enregistrez-les directement. Une réponse 202 signifie que la fusion s'exécute de manière asynchrone : interrogez le système. Location URL jusqu'en 200.

En quoi le traitement synchrone et le traitement asynchrone diffèrent-ils ?

Le async Ce paramètre modifie le contrat de réponse, et non le résultat de la fusion. Choisissez en fonction de la taille du lot.

Synchrone vs asynchrone	`"async": false` (défaut)	`"async": true`
Réponse sur success	200 avec la fusion PDF sous forme d'octets bruts	202 Accepted avec un `Location` sondage URL
Connexion	Resté ouvert jusqu'à la fin de la fusion	Retours immédiats
Comment obtenir le fichier	Enregistrez directement le corps de la réponse	GET le Location URL toutes les ~10 secondes jusqu'à ce qu'il réponde à 200 avec les octets
Idéal pour	Quelques petits fichiers	Lots importants et documents volumineux

API champs corporels

Paramètre	Requis	Taper	Ce que cela fait	Exemple
`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`

Exemples de charges utiles

Fusionner deux PDFs de manière synchrone

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

Fusionner un lot important de manière asynchrone

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

Conseils pour la collecte par le facteur

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.

Exemple 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

Que signifie le API retour?

Champ	Taper	Ce qu'il contient
`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.

Exemples de code

Exemples officiels et exécutables pour ce point de terminaison précis, par language:

FAQ

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.

Pourquoi fusionner PDFs via API au lieu d'un outil de bureau ?

Les outils de fusion de fichiers pour ordinateur et navigateur web conviennent parfaitement aux tâches ponctuelles, mais ils nécessitent une intervention humaine pour sélectionner les fichiers, les réorganiser et télécharger le résultat. API Effectue la même concaténation qu'une requête déterministe par lot, l'ordre étant fixé par votre code plutôt que par glisser-déposer. Le résultat est un format standard. PDF conforme à la ISO Spécifications 32000, il s'ouvre donc dans n'importe quel lecteur et s'intègre parfaitement à l'étape suivante du pipeline, qu'il s'agisse de la compression, OCR, ou signature électronique.