ForHosting KIT · Documenti e PDF

Sovrapponga due PDF e descriva ogni pagina combinata

Sovrapporre due PDF spiega il contenuto di una composizione pagina per pagina prima che Lei crei o controlli il documento finale.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Fornisca una descrizione ordinata per ogni pagina del PDF di base e una per ogni pagina del PDF sovrapposto. Il risultato conserva gli abbinamenti, indica l'ordine dei livelli e produce una descrizione concisa di ogni pagina combinata. È particolarmente utile per controllare modelli di timbri, carta intestata, segni di approvazione e altri elementi grafici ripetuti. Se il numero di pagine è diverso, la richiesta viene rifiutata perché manca una corrispondenza univoca.

Descriva entrambi i PDF nell'ordine delle pagine

Inizi con due array contenenti testo estratto o brevi descrizioni visive, una stringa per ogni pagina del PDF. L'array pages_base rappresenta il documento sottostante, mentre pages_overlay rappresenta quello collocato sopra. Mantenga ogni array nell'ordine originale: la prima descrizione di base viene abbinata alla prima descrizione sovrapposta, la seconda alla seconda e così via. Una descrizione può citare testo, loghi, timbri, bordi, campi modulo o qualsiasi altro elemento rilevante per il controllo. Usi una stringa vuota quando una pagina reale è bianca; non elimini la voce, perché sposterebbe tutti gli abbinamenti successivi. Questa capacità descrive una composizione prevista o estratta, invece di modificare i byte del PDF. È quindi adatta a verifiche di processo, registri di audit e anteprime leggibili quando un altro sistema ha già estratto il contenuto o conosce il progetto del modello. Entrambi i campi devono essere array non vuoti, ogni elemento deve essere una stringa e il limite di input evita elaborazioni accidentalmente ingestibili.

Interpreti il risultato della sovrapposizione

Per ogni numero di pagina, la risposta identifica il livello di base inferiore e il livello sovrapposto superiore. L'ordine esplicito è importante: un timbro, un'intestazione o un'annotazione nel PDF superiore viene concettualmente disegnato dopo il documento sottostante e, nel file renderizzato, può coprirne una parte. Poiché le semplici descrizioni non includono coordinate, colori, trasparenza, caratteri o confini precisi degli oggetti, lo strumento non dichiara di rilevare collisioni a livello di pixel. Fornisce invece un resoconto deterministico del materiale descritto che contribuisce a ciascuna pagina composta. Le pagine bianche ricevono un trattamento specifico. Se la pagina sovrapposta è vuota, la risposta indica che la base resta libera; se la base è vuota, solo il livello superiore apporta contenuto descritto; se entrambe sono vuote, tale stato viene registrato direttamente. Gli spazi vengono normalizzati affinché le descrizioni copiate dagli strumenti di estrazione restino leggibili e stabili. Gli stessi input producono sempre la stessa sequenza e formulazione, rendendo affidabili i risultati nei test automatici e nei registri di approvazione.

Individui gli errori nel numero di pagine prima della produzione

Una sovrapposizione ha senso soltanto quando ogni pagina di base dispone esattamente di una pagina superiore corrispondente. La capacità confronta quindi la lunghezza dei due array prima di descrivere qualsiasi cosa e restituisce un errore di input non valido quando differiscono. Questo comportamento rigoroso intercetta un errore comune nella produzione documentale: un modello di timbro di due pagine applicato a un contratto di tre, oppure una copertina inserita in un file ma non nell'altro. Corregga i documenti sorgente o aggiunga intenzionalmente la descrizione di una pagina bianca per uniformare le strutture, quindi esegua nuovamente la richiesta. La risposta include il numero di pagine verificato, l'ordine generale dal basso verso l'alto e un record numerato per ogni coppia, così Lei può confrontarlo con una distinta di lavorazione o inserirlo in un'interfaccia di revisione. L'automazione tramite API costa $0.002 per richiesta. Poiché l'elaborazione è locale, deterministica e senza rete o modelli, le descrizioni sensibili non vengono inviate a fornitori esterni e la formulazione non cambia tra esecuzioni identiche.

Casi d'uso

Controlli un timbro di approvazione

Verifichi che ogni pagina del contratto sia abbinata alla descrizione prevista del timbro di approvazione o revisione.

Verifichi i modelli di carta intestata

Descriva come intestazioni, piè di pagina o bordi specifici si collocano sopra il contenuto esistente.

Convalidi l'assemblaggio dei documenti

Rilevi una pagina di modello mancante o aggiuntiva prima che un renderer a valle combini i PDF di produzione.

Domande frequenti

Questo strumento crea un nuovo PDF?

No. Restituisce una descrizione strutturata della composizione pagina per pagina; non modifica né renderizza i byte del PDF.

Quale PDF si trova sopra?

pages_overlay è il livello superiore, mentre pages_base è quello inferiore.

Che cosa accade se il numero di pagine è diverso?

La richiesta non riesce e restituisce un errore di input non valido che riporta entrambi i valori.

Come deve essere rappresentata una pagina bianca?

Mantenga la sua posizione nell'array e usi una stringa vuota, così le pagine successive restano correttamente abbinate.

È possibile rilevare se un timbro nasconde parole specifiche?

No. Le descrizioni testuali non forniscono geometria o trasparenza; il risultato descrive i livelli, non l'occlusione a livello di pixel.

Quanto costa?

Ogni richiesta API 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/overlay-two-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/overlay-two-files \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages_base":["Invoice 1042: customer, line items, and total due","Payment terms and bank details"],"pages_overlay":["APPROVED stamp centered across the page","APPROVED stamp centered across the page"]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/overlay-two-files", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pages_base": [
      "Invoice 1042: customer, line items, and total due",
      "Payment terms and bank details"
    ],
    "pages_overlay": [
      "APPROVED stamp centered across the page",
      "APPROVED stamp centered across the page"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/overlay-two-files",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pages_base": [
        "Invoice 1042: customer, line items, and total due",
        "Payment terms and bank details"
    ],
    "pages_overlay": [
        "APPROVED stamp centered across the page",
        "APPROVED stamp centered across the page"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/overlay-two-files", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pages_base":["Invoice 1042: customer, line items, and total due","Payment terms and bank details"],"pages_overlay":["APPROVED stamp centered across the page","APPROVED stamp centered across the page"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pages_base":["Invoice 1042: customer, line items, and total due","Payment terms and bank details"],"pages_overlay":["APPROVED stamp centered across the page","APPROVED stamp centered across the page"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/overlay-two-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

{
  "pages_base": [
    "Invoice 1042: customer, line items, and total due",
    "Payment terms and bank details"
  ],
  "pages_overlay": [
    "APPROVED stamp centered across the page",
    "APPROVED stamp centered across the page"
  ]
}

Esempio di risposta

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