ForHosting KIT · Documenti e PDF

Anteprima di un PDF

Questo strumento genera la miniatura di un PDF: un’immagine della prima pagina, o della copertina, da mostrare al posto della solita icona anonima. Serve a chi gestisce liste di documenti, cataloghi o schede prodotto e vuole che ogni file si riconosca al volo, senza aprirlo.

● Stabileper richiesta + per documento$0.040

Esegui — $0.040 + $0.001/documento Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Esegui online

Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.

Un file si sceglie con gli occhi

Una lista di PDF tutti uguali, con la stessa icona rossa, costringe ad aprirli uno per uno per capire quale sia quello giusto. Una miniatura cambia tutto: la copertina di una brochure, la prima pagina di una relazione, la testata di una fattura si riconoscono a colpo d’occhio. Nelle gallerie di documenti, nei portali e nelle schede prodotto, l’anteprima è ciò che fa cliccare la persona sul file corretto al primo tentativo.

Come nasce la miniatura

Carichi il PDF e ricevi un’immagine della prima pagina, alle dimensioni adatte a una libreria o a una griglia. È un’operazione di sola lettura: il documento non viene toccato, si genera solo l’anteprima. Puoi produrla per un file singolo o per un intero archivio, così ogni voce della tua lista mostra la propria copertina invece dell’icona di sistema che non dice niente.

Un esempio concreto

Una casa editrice di Roma vende ebook e dispense in PDF sul proprio sito. Prima ogni prodotto mostrava la stessa icona grigia; ora ciascuna scheda porta la miniatura della copertina reale, generata dal PDF stesso. Il risultato è una vetrina che si sfoglia con gli occhi, dove il lettore riconosce il titolo che cerca senza aprire nulla — e clicca di più, perché vede cosa sta per comprare.

Prezzo e limiti

$0.040 a documento, prezzo pubblicato, senza abbonamento né registrazione. Il PDF può pesare fino a 25 MB e arrivare a 200 pagine (la miniatura è della copertina). Lo esegui qui sul sito o via API: quest’ultima è comoda per generare le anteprime di un catalogo intero, un file per volta, sommando i centesimi in dollari.

Casi d'uso

Vetrina di ebook e dispense

Una casa editrice mostra la copertina reale di ogni PDF in vendita al posto dell’icona standard: la pagina prodotto diventa una vetrina sfogliabile e il lettore riconosce subito il titolo.

Archivio documentale aziendale

Studio Commercialista Bianchi di Bologna aggiunge la miniatura della prima pagina a ogni documento archiviato: nella lista si distingue a colpo d’occhio una fattura da un contratto senza aprirli.

Allegati nelle email di marketing

Un’azienda inserisce l’anteprima del catalogo in PDF nella newsletter: chi la riceve vede la copertina invece di un link anonimo, e clicca di più per scaricarlo.

Portale della PA o intranet

Un ente pubblica moduli e delibere in PDF su un portale interno: la miniatura di copertina aiuta gli impiegati a trovare il documento giusto tra decine di file simili.

Domande frequenti

L’anteprima è sempre della prima pagina?

Sì, la miniatura riprende la prima pagina, che di norma è la copertina o la testata del documento — proprio ciò che serve per riconoscere il file in una lista.

Che differenza c’è con la conversione in immagini?

La miniatura è una sola immagine, quella di copertina, pensata per gallerie e liste. La conversione in immagini trasforma invece ogni pagina in un file, quando ti servono tutte le pagine e non solo l’anteprima.

Posso scegliere le dimensioni della miniatura?

Sì, imposti la dimensione adatta alla tua griglia o libreria. Per un catalogo conviene una misura uniforme, così tutte le schede risultano allineate.

Quanto costa generare le anteprime?

$0.040 a documento, prezzo pubblicato in dollari, a consumo e senza abbonamento. Per un catalogo intero chiami lo strumento una volta per file e sommi i centesimi.

Il generatore modifica il PDF originale?

No. L’operazione è di sola lettura: creiamo l’immagine di copertina senza toccare il documento, che resta come l’hai caricato.

I file caricati restano riservati?

Il PDF viene elaborato solo per produrre la miniatura e poi eliminato, senza usi ulteriori né cessioni a terzi, nel rispetto del GDPR.

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/thumbnail

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/thumbnail \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"pdf":"https://ejemplo.com/documento.pdf"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/thumbnail",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]

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

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

Esempio di risposta

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

per documento$0.001

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.
`422`	`task_failed`	L'attività non è andata a buon fine: non ti viene addebitato nulla.

Leggi la documentazione completa del KIT →