ForHosting KIT · Documenti e PDF

Crei una griglia di miniature delle pagine PDF

Trasformi il numero di pagine di un PDF e la quantità scelta di colonne in una specifica esatta della griglia.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Il calcolatore restituisce le righe necessarie, il totale delle celle e quante miniature occupano l’ultima riga. È utile per visualizzatori PDF, provini a contatto, pannelli di revisione, piani di stampa e interfacce che devono riservare uno spazio prevedibile prima che le immagini delle singole pagine siano disponibili.

Pianifichi la griglia prima di generare le miniature

Un’interfaccia di miniature PDF spesso deve conoscere la propria struttura prima che il rendering delle immagini sia terminato. Indichi il numero di pagine e le colonne desiderate: il calcolatore restituisce subito il numero esatto di righe. Comunica inoltre la capacità totale del rettangolo e quante miniature reali occupano l’ultima riga. Questi tre valori consentono di riservare uno spazio stabile, creare segnaposto, dimensionare un’area di scorrimento o suddividere il lavoro senza aprire né modificare il PDF. Per esempio, un documento di 23 pagine disposto su cinque colonne richiede cinque righe, offre 25 celle e colloca tre miniature nell’ultima riga. Il calcolo usa aritmetica intera deterministica, quindi gli stessi dati producono sempre lo stesso risultato. La funzione non genera immagini, non esamina i byte del PDF, non sceglie dimensioni e non applica stili visivi. Risponde esclusivamente alla domanda di pianificazione, senza rete, caricamenti di file o ipotesi nascoste sulla visualizzazione.

Interpreti correttamente righe, celle e ultima riga

Il valore rows è il minimo numero intero di righe capace di contenere tutte le pagine con le colonne richieste. Total cells è il prodotto tra righe e colonne e descrive la capacità del rettangolo completo, comprese le posizioni inutilizzate dopo l’ultima miniatura. Last-row fill conta le miniature reali nell’ultima riga. Quando il numero di pagine è divisibile esattamente per le colonne, la riga finale è piena e il suo riempimento equivale alle colonne; non viene restituito zero. La convenzione facilita cicli, etichette accessibili e stili. Entrambi gli input devono essere interi positivi sicuri. Valori frazionari, mancanti, testuali, infiniti, nulli o negativi vengono rifiutati senza arrotondamenti né conversioni implicite. Meno di una colonna non è valido, poiché nessun numero finito di righe può collocare pagine in una griglia priva di colonne. Il contratto rigoroso individua gli errori di configurazione alla fonte.

Usi il risultato nei visualizzatori e nei flussi documentali

In un visualizzatore, usi le righe per stimare l’altezza della galleria conoscendo l’altezza delle miniature e la distanza tra righe. Il totale delle celle può alimentare un elenco di segnaposto a dimensione fissa. Confronti la capacità con il numero di pagine per ricavare gli spazi vuoti, anche se il riempimento finale è normalmente il riferimento più chiaro per lo stile dell’ultima riga. In un pannello renderizzato dal server, gli stessi valori dividono le pagine in blocchi prevedibili o generano riferimenti di paginazione prima che i processi di immagine terminino. I provini a contatto possono scegliere l’orientamento della carta in base alle righe; i test possono verificare una pagina, una griglia completa o una riga finale con una miniatura. Poiché la funzione riceve metadati e non il PDF, Lei deve ottenere altrove un conteggio affidabile delle pagine. Ogni calcolo API costa $0.002; il browser offre lo stesso calcolo puro in forma interattiva.

Casi d'uso

Riservi la galleria di un visualizzatore PDF

Calcoli le righe prima che le miniature siano pronte per evitare fastidiosi spostamenti dell’impaginazione.

Prepari un provino a contatto

Determini la capacità rettangolare e l’occupazione finale per il numero di colonne selezionato.

Verifichi i punti di adattamento

Confronti risultati esatti con colonne diverse e controlli i limiti mediante test automatici dell’interfaccia.

Domande frequenti

Quanto costa un calcolo?

Ogni calcolo tramite API costa $0.002. In questa pagina è disponibile anche il calcolo interattivo.

total_cells equivale sempre a page_count?

No. Il totale indica la capacità del rettangolo completo e può includere posizioni vuote in un’ultima riga parziale.

Che cosa accade quando l’ultima riga è piena?

Il riempimento equivale alle colonne. Una riga finale completa viene indicata come piena, non con zero.

Le colonne possono essere zero?

No. Devono essere un intero positivo; i valori inferiori a 1 producono un errore di input non valido.

Questa funzione legge o genera il PDF?

No. Usa solo il numero di pagine fornito e restituisce valori di impaginazione; non riceve byte PDF e non crea immagini.

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/page-thumbnail-grid-layout

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/page-thumbnail-grid-layout \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_count":23,"columns":5}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_count": 23,
    "columns": 5
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"page_count":23,"columns":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", 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

{
  "page_count": 23,
  "columns": 5
}

Esempio di risposta

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