Vérifiez la linéarisation et l'affichage web rapide d'un PDF
La linéarisation d'un PDF est une organisation structurelle qui permet à un lecteur compatible d'afficher la première page pendant que le reste du document distant continue de se télécharger.
Lancer gratuitement
Ce vérificateur reçoit l'indicateur booléen produit par un outil d'inspection PDF et le transforme en constat concis, prêt à intégrer dans un rapport. Il précise si l'affichage web rapide est annoncé, en explique l'effet concret, distingue l'optimisation de diffusion de la validité du fichier et propose l'étape suivante sans téléverser ni réécrire le PDF.
Interprétez correctement l'indicateur structurel
Un inspecteur PDF peut présenter la linéarisation sous forme d'indicateur booléen, parfois avec des libellés tels qu'Affichage web rapide ou Optimisé pour le web. Saisissez ce résultat structurel exact dans le champ linearized : true signifie que le dictionnaire et l'ordre attendus ont été reconnus, tandis que false indique que le fichier n'annonce pas cette organisation. Le vérificateur exige volontairement cet indicateur au lieu de déduire le résultat du nom, de la taille, de la vitesse de téléchargement ou d'une métadonnée. Ces indices indirects ne révèlent pas l'ordre des objets dans le document. La réponse reprend le booléen normalisé, fournit un état stable aux traitements automatisés et rédige un résumé clair pour un rapport technique. Si l'inspection ne fournit pas l'indicateur, ne le remplacez pas par false. Une observation absente signifie que l'état reste inconnu, alors que false constitue un constat structurel précis. La capacité renvoie donc une erreur de saisie lorsque l'indicateur manque ou n'est pas booléen, afin qu'aucune conclusion non étayée n'entre dans un audit ou un contrôle qualité.
Comprenez l'effet de l'affichage web rapide
Un PDF linéarisé place près du début du fichier les informations nécessaires à un affichage précoce et contient des indications permettant à un lecteur compatible de demander les plages d'octets utiles. Si le serveur accepte les requêtes par plage, un navigateur ou lecteur PDF compatible peut afficher la première page avant d'avoir reçu la totalité du fichier. Cette organisation améliore parfois la réactivité perçue pour les documents volumineux, les connexions lentes et les personnes qui ne consultent que les premières pages. Le rapport reste prudent : l'indicateur structurel rend cette diffusion possible, sans garantir les performances. Le résultat concret dépend également de la livraison HTTP, du cache, de la latence, du lecteur, de la complexité du document et des transformations ultérieures. La linéarisation ne compresse pas le PDF, ne réduit pas son nombre de pages, ne certifie pas son accessibilité, ne valide pas les signatures et ne prouve pas sa conformité générale. Inversement, un petit PDF non linéarisé ou déjà en cache peut s'ouvrir rapidement. Le constat doit donc parler d'aptitude à la diffusion progressive, sans annoncer un gain de vitesse mesuré.
Intégrez le constat à un rapport ou un processus
Pour un résultat positif, consignez que le PDF est linéarisé et prend en charge l'affichage web rapide, tout en rappelant que les conditions de diffusion déterminent le bénéfice observé. Pour un résultat négatif, indiquez que cet affichage n'est pas annoncé et que la première page distante peut nécessiter le téléchargement d'une plus grande partie du fichier. Ne qualifiez pas le document de corrompu : les PDF non linéarisés sont courants et peuvent être parfaitement valides. La recommandation reste conditionnelle : linéarisez le fichier lorsque la consultation HTTP progressive compte, puis inspectez de nouveau le résultat réécrit. Une modification, optimisation, signature, fusion ou régénération peut changer l'ordre interne et supprimer une linéarisation auparavant valide. Dans une publication automatisée, lancez l'inspection après la dernière étape de production, transmettez ici son booléen et conservez l'état et l'explication avec les preuves de livraison. Les champs stables simplifient aussi les règles : un flux web peut exiger true, alors qu'un flux d'archivage ou local peut accepter les deux valeurs à titre informatif.
Cas d’usage
Documenter un contrôle avant publication web
Transformez l'indicateur structurel d'un inspecteur en constat cohérent avant de publier un PDF volumineux sur un site.
Normaliser le résultat du contrôle qualité
Convertissez true ou false en champs d'état stables et en texte que les contrôles suivants pourront enregistrer et comparer.
Expliquer prudemment un résultat négatif
Précisez que l'absence d'affichage web rapide touche la diffusion progressive, sans signifier à elle seule que le PDF est invalide.
Questions fréquentes
Quelle donnée le vérificateur attend-il ?
Il attend l'indicateur booléen de linéarisation issu d'une inspection structurelle du PDF : true ou false. Une valeur absente ou inconnue n'est pas assimilée à false.
Cette capacité inspecte-t-elle ou téléverse-t-elle le PDF ?
Non. Elle interprète un indicateur structurel déjà produit par une autre étape d'inspection PDF.
Un PDF linéarisé s'ouvre-t-il toujours plus vite ?
Non. La diffusion progressive devient possible, mais l'expérience dépend du serveur, du lecteur, de la connexion, du cache, de la complexité et de la taille du fichier.
Un PDF non linéarisé est-il endommagé ?
Non. L'absence de linéarisation concerne l'optimisation de diffusion ; elle ne prouve ni corruption ni invalidité.
Une modification peut-elle supprimer la linéarisation ?
Oui. Réécrire, fusionner, signer ou optimiser le fichier peut modifier l'ordre des objets ; inspectez donc de nouveau le document final.
Quel est le prix d'une requête API ?
Chaque requête API coûte $0.002. La version dans le navigateur exécute localement la même interprétation déterministe.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"linearized": true
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.linearize_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_mb | 25 |
max_pages | 200 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |