ForHosting KIT · Documenti e PDF

Unisca file PDF online nell’ordine che preferisce

Unire file PDF combina due o più riferimenti in un unico documento scaricabile, rispettando esattamente l’ordine indicato.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Il risultato comunica anche il numero totale di pagine, così Lei può verificarlo in un flusso automatizzato. L’operazione è deterministica, non usa la rete né modelli esterni e rifiuta le richieste incomplete prima dell’elaborazione. È adatta quando documenti prodotti separatamente devono diventare una consegna prevedibile, un elemento d’archivio, una pratica o un singolo download per il cliente.

Disponga ogni sorgente nella sequenza prevista

Raccolga innanzitutto i riferimenti PDF destinati al documento finale. La posizione è importante: tutte le pagine del primo file precedono quelle del secondo e lo stesso criterio continua per l’intero elenco. È ideale per fascicoli in cui la sequenza ha valore, come copertina, contratto, allegati e foglio firme. Controlli l’elenco prima di avviare l’unione, perché lo strumento non deduce l’ordine da nomi, metadati o contenuto. Servono almeno due file e ogni riferimento deve contenere dati PDF leggibili. Se il Suo sistema compone l’elenco automaticamente, applichi la sequenza quando le regole aziendali sono note, senza affidarsi all’ordine di una cartella, all’orario di caricamento o a chiavi casuali.

Comprenda come vengono trattati pagine e risultato

Il motore legge gli oggetti pagina di ogni sorgente, ne conserva dimensioni e contenuto e scrive un nuovo PDF con un proprio albero delle pagine e una propria tabella dei riferimenti. Non usa servizi di conversione, casualità o data corrente; pertanto, gli stessi input nella medesima sequenza generano lo stesso risultato. La risposta include il PDF unito, il numero di file e il totale delle pagine effettivamente accettate. La versione beta supporta intenzionalmente pagine autonome senza risorse esterne e rifiuta strutture che non può preservare in sicurezza. In questo modo non consegna un documento apparentemente valido ma privo di caratteri o elementi grafici.

Verifichi e automatizzi il documento concluso

Dopo l’esecuzione, confronti total_page_count con il valore atteso dal Suo processo. Un fascicolo con un accordo di due pagine, un allegato di quattro e una firma di una deve indicare sette pagine. Questo semplice controllo rileva sorgenti mancanti prima dell’archiviazione, dell’invio o della firma. file_count offre una seconda verifica ai sistemi che conoscono il numero previsto di componenti. Poiché l’operazione è pura e deterministica, può essere ripetuta senza cambiare l’ordine. L’automazione tramite API costa $0.002 per richiesta. Conservi gli originali fino alla conferma, assegni un nome chiaro al file finale e registri gli identificatori ordinati anziché l’intero contenuto PDF quando serve una traccia di controllo.

Casi d'uso

Preparare un fascicolo contrattuale

Combini accordo, allegati e foglio firme nella sequenza approvata, quindi verifichi il totale delle pagine.

Offrire un solo download al cliente

Unisca lettera, fattura e documentazione affinché il cliente scarichi un PDF ordinato invece di più allegati.

Creare una consegna per l’archivio

Riunisca rapporti generati separatamente in un elemento di conservazione e registri i totali di file e pagine.

Domande frequenti

Quanti file PDF sono necessari?

Occorrono almeno due riferimenti PDF. Un elenco vuoto, un solo file o un valore diverso da un elenco genera un errore di input.

L’ordine dell’elenco è importante?

Sì. I file vengono elaborati dal primo all’ultimo e tutte le pagine di ciascuno precedono quelle del successivo.

Come viene calcolato il totale delle pagine?

Il parser conta le pagine leggibili accettate da ogni sorgente e ne restituisce la somma in total_page_count.

Quanto costa un’unione automatizzata?

Ogni richiesta API costa $0.002. Per questa capacità non è previsto alcun supplemento per pagina.

Le strutture PDF non supportate vengono ignorate?

No. Il parser beta rifiuta le strutture che non può preservare in sicurezza, evitando risultati incompleti.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo 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)

Esempio di richiesta

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

Esempio di risposta

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Limiti

`max_mb`	25
`max_pages`	200

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →