Passa al contenuto principale

API di compressione delle immagini: test Postman passo passo per file JPG più piccoli

· 11 minuti di lettura
SEO and Content Writer

Le immagini pesanti rallentano le pagine, aumentano i costi della larghezza di banda e contrastano Elementi essenziali del sito Web: particolarmente Vernice più grande e più ricca di contenuti (LCP) quando una foto di grandi dimensioni è l'elemento principale. Un API di compressione delle immagini Consente di ridurre le dimensioni dei file JPG/PNG all'interno della pipeline (gestori di caricamento, importazioni CMS, flussi di lavoro DAM) anziché correggere i file manualmente.

Questa procedura guidata utilizza PDF4me POST /api/v2/CompressImage con Postino: lo stesso schema funziona nel codice una volta che la forma della richiesta è chiara. Per un primo test senza codice, utilizzare l'interattivo Tester dell'API Compress Image: raggiunge lo stesso endpoint con campi modulo anziché con JSON grezzo.

Come leggere questa guida
  • Segui i passaggi 1 → 5Gli screenshot corrispondono a un'esecuzione reale (i tempi e il numero di byte varieranno in base al contenuto dell'immagine e alla rete).
  • Sostituisci il segnaposto del postino {{BASE64_OF_INPUT_IMAGE}} con Base64 di tuo file, no dati:immagine/jpeg;base64, prefisso nella stringa JSON.
  • Dopo una chiamata riuscita, decodifica la risposta a .jpg e confrontare dimensione del file in Esplora risorse (o Finder di macOS) all'originale.
La versione breve

1. Codifica la tua immagine in Base64 → 2. INVIARE https://api.pdf4me.com/api/v2/CompressImage con Content-Type: application/json E Autorizzazione (la tua chiave API di PDF4me) → 3. Corpo JSON: docContent, docName, imageType, Livello di compressione, asincrono4. Aspettarsi 200 OK e un payload JPEG (byte grezzi o Base64, a seconda di come il client lo visualizza) → 5. Salva e confronta le dimensioni del disco con quelle del file sorgente.

Perché i team utilizzano un'API di compressione delle immagini (contesto di mercato)

PrioritàCosa cambia con un'API
Prestazioni webLe immagini di dimensioni ridotte vengono decodificate e trasferite più rapidamente, aspetto importante quando LCP dipende da un singolo file di grandi dimensioni.
esperienza utenteLe pagine si caricano in modo affidabile sui dispositivi mobili quando le immagini sono più leggere, riducendo i tempi di interazione.
OperazioniUn unico contratto HTTP per microservizi, gestori di caricamento serverless e processi ETL, senza strumenti desktop di mezzo.
CostoMeno traffico in uscita e spazio di archiviazione rispetto alla distribuzione di file originali multi-MB ovunque.

PDF4me smaschera livelli di compressione Massimo, Mezzo, Basso) in modo da poter allineare le miniature con le immagini principali. Vedi la panoramica dei parametri in Comprimere l'immagine (riferimento completo all'API) e la tabella riassuntiva qui sotto.

Prima di inviare la prima richiesta

Lista di controllo
  1. Chiave API: dal dashboard PDF4me (utilizzato nel Autorizzazione intestazione per documenti ufficiali).
  2. Formato di input: JPG o PNG (vedi Test API (note sui parametri).
  3. File di grandi dimensioni / timeout: impostato "async": vero quando consigliato, oppure pre-elaborare con Ridimensiona l'immagine se i pixel superano di gran lunga le dimensioni dello schermo.
  4. Quota: autorizzazione fallita o limiti del piano, utilizzare Risoluzione dei problemi di PDF4me se visualizzi errori di tipo 401/402.

Riferimento: campi del corpo JSON

CampoRuolo
docContentCodifica Base64 dell'immagine sorgente (obbligatoria).
docNameNome del file di output, ad esempio output.jpg (necessario).
imageTypeFormato di output, ad esempio JPG O PNG.
Livello di compressioneMassimo, Mezzo, O Basso.
asincronoVERO / falsoUtilizzare la modalità asincrona quando il tempo di elaborazione potrebbe superare i timeout del client.

Passaggio 1: Partire da un file "prima" reale

Per esercitarsi, utilizzare un JPG di grandi dimensioni. La corsa di riferimento qui sotto ha utilizzato un ~4,5 MB file sorgente denominato input.jpg in Esplora risorse di Windows, di dimensioni sufficientemente grandi da rendere la compressione visibilmente significativa nelle proprietà della cartella.

Esplora risorse di Windows mostra un file di input JPG di grandi dimensioni (~4,48 MB) prima di chiamare l'API di compressione.

Passaggio 2: Configura la richiesta Postman (metodo + URL)

Apri il Intestazioni scheda. Come minimo è necessario Content-Type: application/json e la tua chiave PDF4me in Authorization (sostituisci il segnaposto dello screenshot con la tua chiave reale).

Scheda Intestazioni di Postman per Compress Image: URL POST e autorizzazione

Passaggio 3: Imposta il corpo JSON non elaborato

Scegliere Corpo → grezzo → JSON, quindi incolla un payload con questa forma (sostituisci con la tua stringa Base64).

Scheda Corpo di Postman con docContent, docName, imageType, compressionLevel e async

{
"docContent": "PASTE_BASE64_HERE_NO_DATA_URL_PREFIX",
"docName": "output.jpg",
"imageType": "JPG",
"compressionLevel": "Max",
"async": false
}
Opzionale: verifiche minime prima di cliccare su Invia
  • JPEG Base64 spesso inizia con /9j/ quando lo strumento mostra la forma stringa, questa corrisponde alla firma del file JPEG.
  • Se Postman è lento, la richiesta potrebbe comunque avere successo, fai attenzione a 200 OK e salvare l'output; considerare asincrono: vero per lavori di produzione in lotti.
  • Per un modulo guidato invece di JSON, apri Comprimere l'immagine nell'API Tester e confrontare gli stessi campi uno accanto all'altro.

Passaggio 4: Invia e leggi la risposta

Quando il client mostra Base64

Se il Corpo lo spettatore è impostato su Base64 e vedi una lunga fila che inizia con /9j/Il payload è costituito da dati JPEG codificati per la visualizzazione. Decodificali in un file e aprilo con un visualizzatore di immagini per verificarne la qualità.

Postman 200 OK con corpo della risposta interpretato come JPEG Base64

Quando il client mostra il binario grezzo

Alcune viste rendono crudo byte (i metadati come XMP possono apparire come testo leggibile all'interno del flusso). A 200 OK significa ancora che l'immagine compressa è stata restituita, salva il corpo come output.jpg utilizzando l'opzione "Salva risposta" del tuo client.

Postman 200 OK con corpo della risposta non elaborato (binario / metadati visibili)

Passaggio 5: Confrontare le dimensioni del file "dopo" sul disco

Dopo aver scritto la risposta su disco, controlla Proprietà di nuovo. Nell'esecuzione di riferimento, il file compresso è atterrato vicino ~2,6 MB: una riduzione utile su una foto multi-megabyte mantenendo semplice il flusso di lavoro. Il tuo rapporto dipende dal contenuto, dalle dimensioni e Livello di compressione; Tentativo Mezzo O Basso Se Massimo è troppo aggressivo per le foto del prodotto.

Esplora risorse di Windows che mostra le dimensioni del file compresso output.jpg dopo la chiamata API

Risoluzione dei problemi (rapida)

401 / errori di autenticazione

Conferma la chiave in Autorizzazione e che la chiave sia attiva. Vedi Documentazione API E Risoluzione dei problemi.

Timeout o chiamate molto lente

Tentativo "async": vero dove supportato, oppure ridurre prima le dimensioni dei pixel con Ridimensiona l'immagine.

Output “corrotto” o vuoto

striscia dati:immagine/...;base64, prefissi da docContent, rimuovere le interruzioni di riga nella stringa Base64 e verificare che il file sorgente si apra localmente.

Automatizzare senza postino

Letture correlate

Riepilogo: UN API di compressione delle immagini appartiene alla stessa cassetta degli attrezzi delle immagini responsive e della cache CDN: riduce i byte alla sorgente in modo che ogni passaggio successivo sia più economico e veloce. Inizia con il tester APIRiproduci la richiesta in Postman seguendo i passaggi sopra descritti, quindi importa il JSON nel tuo servizio o modulo di automazione quando sei pronto per la distribuzione.