Verifichi linearizzazione e visualizzazione web rapida del PDF
La linearizzazione di un PDF è un'organizzazione strutturale pensata per consentire a un visualizzatore compatibile di mostrare la prima pagina mentre il resto del documento remoto è ancora in download.
Esegui gratis nel browser
Questo controllo riceve l'indicatore booleano prodotto da uno strumento di ispezione PDF e lo trasforma in un esito sintetico, pronto per un rapporto. Indica se è disponibile la visualizzazione web rapida, ne illustra l'effetto pratico, distingue l'ottimizzazione della distribuzione dalla validità del file e suggerisce il passo successivo senza caricare né riscrivere il PDF.
Legga correttamente l'indicatore strutturale
Uno strumento di ispezione PDF può mostrare la linearizzazione come indicatore booleano, talvolta accanto a diciture quali Visualizzazione web rapida oppure Ottimizzato per il web. Inserisca il risultato strutturale esatto nel campo linearized: true significa che sono stati riconosciuti il dizionario e l'ordinamento previsti; false indica invece che il file non dichiara tale organizzazione. Il controllo richiede espressamente l'indicatore e non tenta di dedurlo dal nome, dalle dimensioni, dalla velocità di download o da un'etichetta dei metadati. Questi indizi indiretti non rivelano come siano ordinati gli oggetti nel documento. Il risultato ripete il booleano normalizzato, fornisce uno stato stabile ai flussi automatici e formula un riepilogo chiaro per il rapporto tecnico. Se l'ispezione non contiene l'indicatore, non lo sostituisca con false. Un'osservazione mancante segnala uno stato sconosciuto, mentre false è un esito strutturale preciso. La capacità restituisce quindi un errore di input se l'indicatore manca o non è booleano, impedendo che una conclusione non supportata entri in una verifica o nel controllo qualità.
Comprenda cosa cambia con la visualizzazione rapida
Un PDF linearizzato colloca vicino all'inizio del file le informazioni necessarie alla visualizzazione anticipata e include indicazioni che aiutano un lettore compatibile a richiedere intervalli di byte utili. Se il file risiede su un server che supporta le richieste per intervallo, un browser o visualizzatore PDF compatibile può mostrare la pagina iniziale prima di ricevere tutti i byte. Ciò può migliorare la reattività percepita per documenti voluminosi, connessioni lente e lettori interessati soltanto alle prime pagine. Il rapporto adotta una formulazione prudente, perché l'indicatore strutturale abilita una possibilità e non garantisce le prestazioni. Il comportamento effettivo dipende anche dalla distribuzione HTTP, dalla cache, dalla latenza, dal visualizzatore, dalla complessità del documento e dalle trasformazioni successive. La linearizzazione non comprime il PDF, non riduce le pagine, non certifica l'accessibilità, non convalida le firme e non prova che il documento sia altrimenti ben formato. Analogamente, un PDF non linearizzato può aprirsi rapidamente se piccolo o già in cache. L'esito deve pertanto descrivere l'idoneità alla distribuzione progressiva, non dichiarare un aumento di velocità misurato.
Usi l'esito in un rapporto o in un flusso
Con un risultato positivo, registri che il PDF è linearizzato e supporta la visualizzazione web rapida, conservando l'avvertenza che il beneficio osservato dipende dalle condizioni di distribuzione. Con un risultato negativo, segnali che la modalità rapida non è dichiarata e che la visualizzazione remota della prima pagina può richiedere una parte più ampia del file. Non definisca corrotto il documento: i PDF non linearizzati sono comuni e possono essere pienamente validi. La raccomandazione è condizionale: linearizzi il file se la consultazione HTTP progressiva è importante, quindi ispezioni nuovamente il risultato riscritto. Modificare, ottimizzare, firmare, unire o rigenerare un PDF può cambiarne l'ordine interno e rimuovere una struttura prima valida. In una pubblicazione automatizzata, esegua l'ispezione dopo l'ultima fase di produzione, trasmetta qui il booleano e archivi stato e spiegazione con le prove di rilascio. I campi stabili agevolano anche le regole: un flusso web può imporre true, mentre uno archivistico o locale può accettare entrambi i valori come informazione.
Casi d'uso
Documentare un controllo di pubblicazione web
Trasformi l'indicatore strutturale dell'ispettore in un esito coerente prima di pubblicare un PDF voluminoso su un sito.
Uniformare l'output del controllo qualità
Converta true o false in campi di stato stabili e in testo che i controlli successivi possano archiviare e confrontare.
Spiegare con cautela un esito negativo
Chiarisca che l'assenza della visualizzazione web rapida incide sulla distribuzione progressiva, ma non rende di per sé invalido il PDF.
Domande frequenti
Quale input richiede il controllo?
Richiede l'indicatore booleano di linearizzazione ottenuto da un'ispezione strutturale del PDF: true o false. Un valore assente o sconosciuto non viene accettato come false.
Questa capacità ispeziona o carica il file PDF?
No. Interpreta un indicatore strutturale già prodotto da un'altra fase di ispezione PDF.
Un PDF linearizzato si apre sempre più velocemente?
No. Consente la distribuzione progressiva, ma l'esperienza dipende da server, visualizzatore, connessione, cache, complessità e dimensioni del documento.
Un PDF non linearizzato è danneggiato?
No. La mancanza di linearizzazione riguarda l'ottimizzazione della distribuzione, non dimostra corruzione o invalidità.
Una modifica può rimuovere la linearizzazione?
Sì. Riscrittura, unione, firma o ottimizzazione possono cambiare l'ordine degli oggetti; ispezioni nuovamente il documento finale.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. La versione nel browser esegue localmente la stessa interpretazione deterministica.
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
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/linearize-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"linearized":true}'const res = await fetch("https://api.kit.forhosting.com/pdf/linearize-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"linearized": true
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/linearize-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"linearized": true
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/linearize-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"linearized":true}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"linearized":true}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/linearize-check", 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
{
"linearized": true
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.linearize_check",
"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
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. |