ForHosting KIT · Documents et PDF

Fusionnez des fichiers PDF en ligne dans l’ordre choisi

Fusionner des fichiers PDF réunit au moins deux références dans un document unique à télécharger, en respectant exactement l’ordre fourni.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le résultat indique aussi le nombre total de pages afin que vous puissiez le contrôler dans un flux automatisé. L’opération est déterministe, ne sollicite ni réseau ni modèle externe et refuse les demandes incomplètes avant leur traitement. Elle convient lorsque plusieurs documents produits séparément doivent former une livraison fiable, une archive, un dossier de dépôt ou un téléchargement destiné à un client.

Placez chaque source dans l’ordre attendu

Commencez par rassembler les références PDF destinées au document final. Leur position compte : toutes les pages du premier fichier précèdent celles du deuxième, puis le même principe s’applique au reste de la liste. Cette règle convient aux dossiers structurés, par exemple une couverture, un contrat, des annexes et une feuille de signature. Vérifiez la liste avant le lancement, car l’outil ne déduit aucun ordre à partir des noms, des métadonnées ou du contenu. Deux fichiers au minimum sont requis et chaque référence doit fournir des données PDF lisibles. Si votre système compose la liste, appliquez l’ordre au moment où les règles métier sont connues, sans dépendre d’un classement de dossier, de l’heure d’envoi ou de clés accidentelles.

Comprenez le traitement des pages et du résultat

Le moteur lit les objets de page de chaque source, conserve leurs dimensions et leur contenu, puis écrit un nouveau PDF avec sa propre arborescence et sa propre table de références. Il n’emploie aucun service de conversion, hasard ou date courante : les mêmes entrées dans le même ordre produisent donc le même résultat. La réponse contient le PDF fusionné, le nombre de fichiers et le total des pages réellement acceptées. La version bêta prend volontairement en charge les pages autonomes sans ressources externes et refuse les structures qu’elle ne peut préserver sûrement. Ce choix évite de livrer un document qui semblerait valide, mais dont les polices ou les éléments graphiques auraient disparu.

Contrôlez et automatisez le document final

Après une exécution réussie, comparez total_page_count à la valeur attendue par votre processus. Un dossier composé d’un accord de deux pages, d’une annexe de quatre pages et d’une signature d’une page doit en annoncer sept. Ce contrôle repère une source absente avant l’archivage, l’envoi ou la signature. Le champ file_count fournit un second repère aux systèmes qui connaissent le nombre de composants prévu. L’opération étant pure et déterministe, vous pouvez la relancer sans modifier l’ordre. L’automatisation par API coûte $0.002 par demande. Conservez les originaux jusqu’à l’acceptation, nommez clairement le fichier final et journalisez les identifiants ordonnés plutôt que le contenu intégral lorsqu’une trace d’audit est nécessaire.

Cas d’usage

Constituer un dossier contractuel

Réunissez le contrat, ses annexes et la feuille de signature dans l’ordre approuvé, puis vérifiez le total des pages.

Proposer un téléchargement unique

Regroupez une lettre, une facture et ses justificatifs afin que le client reçoive un PDF organisé plutôt que plusieurs pièces jointes.

Préparer un dépôt d’archives

Fusionnez des rapports produits séparément dans un seul élément de conservation et consignez les totaux de fichiers et de pages.

Questions fréquentes

Combien de fichiers PDF faut-il fournir ?

Au moins deux références PDF sont nécessaires. Une liste vide, un seul fichier ou une valeur qui n’est pas une liste produit une erreur d’entrée.

L’ordre de la liste est-il important ?

Oui. Les fichiers sont traités du premier au dernier, et toutes les pages d’un fichier précèdent celles du suivant.

Comment le total des pages est-il calculé ?

L’analyseur compte les pages lisibles acceptées dans chaque source et renvoie leur somme dans total_page_count.

Quel est le prix d’une fusion automatisée ?

Chaque demande API coûte $0.002. Aucun supplément par page n’est déclaré pour cette capacité.

Les structures PDF incompatibles sont-elles ignorées ?

Non. L’analyseur bêta refuse toute structure qu’il ne peut préserver en sécurité afin d’éviter un résultat incomplet.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/pdf/merge-files

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/pdf/merge-files \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"files":["https://ejemplo.com/archivo.bin","https://ejemplo.com/archivo-2.bin"]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/merge-files", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "files": [
      "https://ejemplo.com/archivo.bin",
      "https://ejemplo.com/archivo-2.bin"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/merge-files",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "files": [
        "https://ejemplo.com/archivo.bin",
        "https://ejemplo.com/archivo-2.bin"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/merge-files", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"files":["https://ejemplo.com/archivo.bin","https://ejemplo.com/archivo-2.bin"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"files":["https://ejemplo.com/archivo.bin","https://ejemplo.com/archivo-2.bin"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/merge-files", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "files": [
    "https://ejemplo.com/archivo.bin",
    "https://ejemplo.com/archivo-2.bin"
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.merge_files",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_mb`	25
`max_pages`	200

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →