ForHosting KIT · Documenti e PDF

Inserisca una pagina bianca in qualsiasi punto del PDF

Inserisca una pagina bianca in un PDF esistente senza ricostruire manualmente il documento.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Fornisca il PDF e una posizione numerata da 1: lo strumento colloca lì una pagina pulita con le stesse dimensioni di quella presente in quel punto. Per aggiungerla in fondo, scelga la posizione successiva all’ultima pagina attuale. L’operazione è deterministica, mantiene l’ordine originale e rifiuta chiaramente le posizioni inesistenti.

Scelga la posizione esatta di inserimento

Le posizioni partono da 1 perché descrivono dove apparirà la nuova pagina a chi leggerà il documento completato. La posizione 1 inserisce un foglio bianco prima dell’attuale prima pagina. La posizione 2 lo colloca tra la prima e la seconda. In un documento di cinque pagine, la posizione 6 aggiunge un foglio dopo la quinta. Queste sono le sole posizioni valide: il minimo è 1 e il massimo equivale al numero di pagine esistenti più uno. La regola esplicita impedisce che una richiesta ambigua produca silenziosamente un documento con il foglio nel punto sbagliato. Se la posizione è zero, negativa, frazionaria o superiore a quella finale, la richiesta restituisce un errore di input e lascia invariata la sorgente. Prima di automatizzare un flusso, conti le pagine e calcoli la posizione in base al documento realmente inviato. Il risultato riporta la posizione inserita e il nuovo totale, così Lei può verificare subito la trasformazione.

Come viene determinato il formato della pagina bianca

La pagina inserita usa il riquadro multimediale effettivo della pagina che si trova nella posizione richiesta. Inserendo prima di un foglio Letter verticale si crea quindi un foglio bianco verticale dello stesso formato; se la pagina successiva è orizzontale o personalizzata, ne vengono mantenute le dimensioni. Quando l’inserimento avviene in fondo non esiste una pagina successiva da esaminare, perciò il nuovo foglio copia il formato dell’ultima pagina esistente. Questo comportamento è utile nei PDF con formati misti, come fascicoli acquisiti, dispense, progetti e raccolte di relazioni. Il foglio è volutamente vuoto: non contiene flussi di contenuto, annotazioni, campi modulo o segni copiati. Viene trasferita solo la geometria. La risposta include inoltre larghezza e altezza calcolate in punti PDF, consentendoLe di verificare le dimensioni scelte. Le pagine originali conservano ordine e contenuto.

Prepari un input compatibile e verifichi il risultato

Fornisca un PDF classico come testo PDF semplice oppure come URI di dati PDF in base64. L’attuale versione beta rifiuta intenzionalmente i documenti con flussi di riferimenti incrociati, invece di tentare di ricostruire strutture non gestibili in sicurezza. Il parser legge catalogo e albero delle pagine, segue i nodi annidati, risolve i riquadri ereditati, inserisce il nuovo riferimento nel genitore corretto, aggiorna tutti i conteggi interessati e ricostruisce una tabella classica valida. Non utilizza rete, orologio, casualità, archiviazione o modelli. Dopo l’elaborazione, controlli il numero di pagine, la posizione, la larghezza e l’altezza restituiti, quindi salvi o inoltri il PDF. Per l’automazione provi prima file rappresentativi. Se un flusso di riferimenti incrociati viene respinto, converta il file in PDF classico con un programma affidabile. Ogni richiesta API costa $0.002; la stessa operazione deterministica è disponibile anche nel browser.

Casi d'uso

Aggiungere un foglio divisorio

Inserisca una pagina pulita tra le sezioni di una relazione unificata per separare o annotare le copie stampate.

Ripristinare l’allineamento fronte-retro

Aggiunga un foglio vuoto dove serve affinché un capitolo o modulo inizi sul lato previsto durante la stampa fronte-retro.

Creare spazio per firme o note

Collochi un foglio vuoto dello stesso formato accanto agli allegati senza ricreare o ridimensionare il PDF originale.

Domande frequenti

Quali posizioni sono valide?

Usi un intero da 1 fino al numero attuale di pagine più uno. L’ultimo valore aggiunge il foglio in fondo.

Quale formato di pagina viene usato?

Il foglio copia il riquadro effettivo della pagina nella posizione indicata o dell’ultima pagina quando viene aggiunto in fondo.

La nuova pagina contiene qualcosa?

No. Ha le dimensioni scelte, ma è priva di contenuti, annotazioni, campi modulo ed elementi grafici copiati.

Che cosa accade se la posizione è fuori intervallo?

La richiesta restituisce un errore di input e non produce un PDF modificato.

Quanto costa la richiesta API?

Ogni richiesta costa $0.002.

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/insert-blank-page

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/insert-blank-page \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf","position":2}'

const res = await fetch("https://api.kit.forhosting.com/pdf/insert-blank-page", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf",
    "position": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/insert-blank-page",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf",
    "position": 2
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf","position":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/insert-blank-page", 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

{
  "pdf": "https://ejemplo.com/documento.pdf",
  "position": 2
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.insert_blank_page",
  "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 →