Linéariser PDF
PDF4me Linéariser PDF est un REST point de terminaison qui restructure un PDF pour un affichage web rapide. POST le fichier comme Base64 à /api/v2/LinearizePdf avec un optimizeProfileet le API réorganise ses objets internes de sorte que la première page s'affiche pendant que le reste est encore en cours de téléchargement, puis renvoie la version linéarisée. PDF sous forme d'octets bruts. Neuf profils couvrent le web, l'impression et la compression.
Il faut PDF et renvoie le même document réorganisé pour le chargement progressif : les informations de répertoire et les ressources de la page 1 sont déplacées au début du fichier, de sorte qu’un navigateur ou une visionneuse intégrée affiche la première page presque immédiatement au lieu d’attendre la fin du téléchargement complet. pages elles-mêmes restent intactes. Idéal pour les portails de documents, les CDN et tout autre PDF servi sur HTTP.
Authentification de votre API Demande
Chaque PDF4me REST L'appel doit inclure votre API clé dans le Authorization En-tête : Authentification de base. Récupérez ou renouvelez votre clé depuis le tableau de bord développeur.
Point de terminaison
/api/v2/LinéariserPdfhttps://api.pdf4me.com/api/v2/LinearizePdfInformations importantes à ne pas manquer
asynchrone, un JSON booléen. Une clé mal formatée est ignorée silencieusement et votre fichier volumineux est traité de manière synchrone.HTTP installation
Méthode: POST
URL: https://api.pdf4me.com/api/v2/LinearizePdf
Type de contenu : application/json
Authorization: Basique <votre PDF4me API clé>
Un corps de réponse de 200 est linéarisé. PDF Sous forme d'octets bruts : enregistrez-les directement. Une réponse 202 indique un traitement asynchrone : interrogez le système. Location URL avec GET environ toutes les 10 secondes (les échantillons officiels utilisent des intervalles de 10 secondes, jusqu'à 10 tentatives) jusqu'à 200.
Quel profil d'optimisation dois-je choisir ?
Neuf profils ont été acceptés. Ils se répartissent en trois familles aux objectifs différents.
| Profil familial vs objectif | Profils | Ce qu'ils optimisent pour |
|---|---|---|
| Web | web, WebMax | Affichage progressif et rendu rapide de la première page dans les navigateurs ; WebMax est l’optimisation web la plus performante. |
| Imprimer | Print, PrintMax, PrintGray | Sortie orientée impression ; PrintGray convertit également en impression en niveaux de gris |
| Compression | Compress, CompressMax | Taille de fichier minimale ; CompressMax privilégie la réduction au détriment de la puissance de traitement. |
| Général | Default, Max | Les paramètres par défaut du moteur et le niveau d'optimisation global maximal |
Pour PDFs servi sur les sites web, commencez par web et passer à WebMax seulement si la latence de la première page reste importante après les tests.
API champs corporels
| Paramètre | Requis | Taper | Ce que cela fait | Exemple |
|---|---|---|---|---|
docContent | Required | string | Base64-encoded bytes of the source PDF. | JVBERi0xLjcK... |
docName | Required | string | Source PDF filename with its .pdf extension. | document.pdf |
optimizeProfile | Required | string | Optimization profile. Allowed values: web, Max, Print, Default, WebMax, PrintMax, PrintGray, Compress, CompressMax. Values are case-sensitive as listed. | web |
async | Optional | boolean | Lowercase JSON boolean. true returns 202 plus a Location URL to poll, for large files. false or omitted returns the linearized PDF directly on 200. | true |
Exemples de charges utiles
Linéariser pour l'affichage Web
{
"docContent": "JVBERi0xLjcKJb...",
"docName": "report.pdf",
"optimizeProfile": "web"
}
Fichier volumineux, asynchrone
{
"docContent": "JVBERi0xLjcKJb...",
"docName": "catalog-2026.pdf",
"optimizeProfile": "WebMax",
"async": true
}
Conseils pour la collecte par le facteur
Exemple curl
curl -X POST https://api.pdf4me.com/api/v2/LinearizePdf \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"docContent": "'"$(base64 -w 0 report.pdf)"'",
"docName": "report.pdf",
"optimizeProfile": "web"
}' \
--output linearized.pdf
Que signifie le API retour?
| Champ | Taper | Ce qu'il contient |
|---|---|---|
200 response body | Binary (application/pdf) | The linearized PDF as raw bytes. Save it directly. The official samples also handle a JSON-wrapped Base64 fallback, but binary is the primary contract. |
202 Location header | URL | Async mode only: the polling URL. GET it about every 10 seconds (samples: 10 retries) until it returns 200 with the PDF bytes. |
4xx/5xx response body | JSON or text | Error details: 400 for malformed Base64 or an unknown optimizeProfile value, 401 for a missing or invalid API key, 500 for server-side processing failures. |
Exemples de code
Exemples officiels et exécutables pour ce point de terminaison précis, par language:
FAQ
Pourquoi linéariser PDFs pour le web ?
Une norme PDF stocke les informations de répertoire à la fin du fichier ; par conséquent, le lecteur doit télécharger la quasi-totalité du contenu avant d’afficher la page 1. Linéarisé PDF, définie comme une annexe normative de la ISO Spécifications 32000, déplace ce répertoire et la première page au premier plan, permettant un accès progressif sur HTTP.Pour un portail de documents ou CDN, ce qui transforme une attente blanche de plusieurs secondes en une première page qui apparaît pendant que le reste arrive en continu.