Zum Hauptinhalt springen

Bildkomprimierungs-API: Schritt-für-Schritt-Postman-Test für kleinere JPGs

· 11 Minuten Lesezeit
SEO and Content Writer

Große Bilder verlangsamen Seiten, treiben die Bandbreitenkosten in die Höhe und arbeiten gegen … Core Web Vitals: besonders Größte Inhaltsfarbe (LCP) Wenn ein großes Foto das Hauptelement ist. Bildkomprimierungs-API Ermöglicht es Ihnen, JPG/PNG-Nutzdaten in der Pipeline (Upload-Handler, CMS-Importe, DAM-Workflows) zu verkleinern, anstatt die Dateien manuell zu korrigieren.

Diese Schritt-für-Schritt-Anleitung verwendet PDF4me POST /api/v2/CompressImage mit BriefträgerDas gleiche Muster funktioniert im Code, sobald die Anfragestruktur klar ist. Für ein erster No-Code-Test, verwenden Sie die interaktive Tester der Compress Image API: Es greift auf denselben Endpunkt zu, indem es Formularfelder anstelle von rohem JSON verwendet.

So lesen Sie diese Anleitung
  • Folgen Sie den Schritten 1 → 5Die Screenshots entsprechen einem realen Durchlauf (Ihre Laufzeiten und Byteanzahlen können je nach Bildinhalt und Netzwerk variieren).
  • Platzhalter „Postbote“ ersetzen {{BASE64_OF_INPUT_IMAGE}} mit der Base64 von dein Datei, nein data:image/jpeg;base64, Präfix in der JSON-Zeichenkette.
  • Nach einem erfolgreichen Anruf wird die Antwort dekodiert. .jpg und vergleichen Dateigröße im Explorer (oder macOS Finder) zum Original.
Die Kurzfassung

1. Base64-kodieren Sie Ihr Bild → 2. POST https://api.pdf4me.com/api/v2/CompressImage mit Content-Type: application/json Und Genehmigung (Ihr PDF4me-API-Schlüssel) → 3. JSON-Inhalt: docContent, docName, Bildtyp, Kompressionsstufe, asynchron4. Erwarten 200 OK und eine JPEG-Nutzlast (Rohbytes oder Base64, je nachdem, wie Ihr Client sie anzeigt) → 5. Speichern und vergleichen Sie die Festplattengröße mit der Quelldatei.

Warum Teams eine Bildkomprimierungs-API verwenden (Marktkontext)

PrioritätWas ändert sich mit einer API?
Web-PerformanceKleinere Bilder lassen sich schneller dekodieren und übertragen, was wichtig ist, wenn LCP von einem einzigen großen Asset abhängig ist.
BenutzererfahrungSeiten laden auf Mobilgeräten zuverlässig, wenn die Bilder kleiner sind, wodurch die Interaktionszeit verkürzt wird.
BetriebEin einziger HTTP-Vertrag für Microservices, serverlose Upload-Handler und ETL-Jobs, ohne Desktop-Tools im Spiel.
KostenWeniger Datenverkehr und Speicherbedarf im Vergleich zur Auslieferung von Originalen mit mehreren Megabyte an jedem beliebigen Ort.

PDF4me enthüllt Kompressionsstufen (Max, Medium, NiedrigSo können Sie die Ausrichtung zwischen Vorschaubildern und Hauptbildern festlegen. Die Parameterübersicht finden Sie in Bild komprimieren (vollständige API-Referenz) und die untenstehende Kurzübersicht.

Bevor Sie die erste Anfrage senden

Checklist
  1. API-Schlüssel: von PDF4me-Dashboard (verwendet in der Genehmigung Überschrift pro offizielle Dokumente).
  2. Eingabeformat: JPG oder PNG (siehe API-Tests Parameterhinweise).
  3. Große Dateien / Zeitüberschreitungen: Satz "async": true wenn empfohlen, oder vorverarbeiten mit Bildgröße ändern wenn die Anzahl der Pixel die Bildschirmgröße deutlich übersteigt.
  4. Quote: Bei fehlgeschlagener Authentifizierung oder Planbeschränkungen verwenden Sie PDF4me-Fehlerbehebung Wenn Sie 401/402-Fehler sehen.

Referenz: JSON-Body-Felder

FeldRolle
docContentBase64-Kodierung des Quellbildes (erforderlich).
docNameAusgabedateiname, z.B. output.jpg (erforderlich).
BildtypAusgabeformat, z.B. JPG oder PNGDie
KompressionsstufeMax, Medium, oder NiedrigDie
asynchronWAHR / FALSCHVerwenden Sie async, wenn die Verarbeitungszeit die Client-Timeouts überschreiten könnte.

Schritt 1: Beginnen Sie mit einer echten „Vorher“-Datei

Verwenden Sie zum Üben eine beliebige große JPG-Datei. Der unten stehende Referenzlauf verwendete eine ~4,5 MB Quelldatei benannt input.jpg im Windows Explorer, groß genug, dass die Komprimierung in den Ordnereigenschaften sichtbar aussagekräftig ist.

Der Windows Explorer zeigt eine große JPG-Eingabedatei (~4,48 MB) vor dem Aufruf der Komprimierungs-API an.

Schritt 2: Postman-Anfrage konfigurieren (Methode + URL)

Öffne die Überschriften Tab. Mindestens benötigen Sie Content-Type: application/json und Ihr PDF4me-Schlüssel Authorization (Ersetzen Sie den Platzhalter im Screenshot durch Ihren echten Schlüssel).

Postman-Registerkarte „Header“ für „Bild komprimieren“: POST-URL und Autorisierung

Schritt 3: Festlegen des rohen JSON-Bodys

Wählen Body → raw → JSONFügen Sie anschließend eine Nutzlast in folgender Form ein (ersetzen Sie „Base64-Zeichenkette“ durch Ihre eigene).

Postman-Body-Tab mit docContent, docName, imageType, compressionLevel und async

{
"docContent": "PASTE_BASE64_HERE_NO_DATA_URL_PREFIX",
"docName": "output.jpg",
"imageType": "JPG",
"compressionLevel": "Max",
"async": false
}
Optional: Minimale Plausibilitätsprüfungen, bevor Sie auf „Senden“ klicken
  • JPEG Base64 beginnt oft mit /9j/ Wenn das Tool die Zeichenkettenform anzeigt, entspricht diese der JPEG-Dateisignatur.
  • Falls Postman langsam ist, kann die Anfrage trotzdem erfolgreich sein; achten Sie auf Folgendes: 200 OK und die Ausgabe speichern; berücksichtigen async: true für Serienfertigungsaufträge.
  • Für ein geführtes Formular anstelle von JSON öffnen Sie Bild im API-Tester komprimieren und vergleichen Sie die gleichen Felder nebeneinander.

Schritt 4: Senden und die Antwort lesen

Wenn der Client Base64 anzeigt

Wenn die Körper Der Betrachter ist auf Folgendes eingestellt: Base64 und Sie sehen eine lange Schlange, die mit beginnt /9j/Die Nutzdaten sind JPEG-Daten, die für die Anzeige kodiert sind. Dekodieren Sie sie in eine Datei und öffnen Sie sie in einem Bildbetrachter, um die Qualität zu überprüfen.

Postman 200 OK, Antworttext als Base64-JPEG interpretiert

Wenn der Client rohe Binärdaten anzeigt

Einige Ansichten werden gerendert roh Bytes (Metadaten wie XMP können als lesbarer Text innerhalb des Datenstroms erscheinen). A 200 OK bedeutet weiterhin, dass das komprimierte Bild zurückgegeben wurde; speichern Sie den Inhalt als output.jpg mithilfe der Option „Antwort speichern“ Ihres Kunden.

Postman 200 OK mit unformatiertem Antworttext (binär / Metadaten sichtbar)

Schritt 5: Vergleichen Sie die Dateigröße auf der Festplatte nach der Bearbeitung.

Nachdem Sie die Antwort auf die Festplatte geschrieben haben, überprüfen Sie Eigenschaften Im Referenzlauf landete die komprimierte Datei erneut in der Nähe von ~2,6 MBEine sinnvolle Reduzierung der Dateigröße eines mehrere Megabyte großen Fotos bei gleichzeitig einfachem Workflow. Das optimale Verhältnis hängt von Inhalt, Abmessungen und … ab. Kompressionsstufe; versuchen Medium oder Niedrig Wenn Max ist für Produktfotos zu aggressiv.

Der Windows Explorer zeigt die Größe der komprimierten output.jpg-Datei nach dem API-Aufruf an.

Fehlerbehebung (schnell)

401 / Authentifizierungsfehler

Bestätigen Sie den Schlüssel in Genehmigung und dass der Schlüssel aktiv ist. Siehe API-Dokumentation Und FehlerbehebungDie

Zeitüberschreitungen oder sehr langsame Anrufe

Versuchen "async": true Wo unterstützt, oder reduzieren Sie zuerst die Pixelabmessungen mit Bildgröße ändernDie

„Beschädigte“ oder leere Ausgabe

Strip data:image/...;base64, Präfixe von docContentEntfernen Sie die Zeilenumbrüche in der Base64-Zeichenkette und überprüfen Sie, ob die Quelldatei lokal geöffnet werden kann.

Automatisieren ohne Postman

Weiterführende Lektüre

Zusammenfassung: Ein Bildkomprimierungs-API gehört in dieselbe Kategorie wie responsive Bilder und CDN-Caching: Es reduziert die Dateigröße an der Quelle, sodass jeder nachfolgende Schritt günstiger und schneller abläuft. Beginnen Sie mit der API-TesterReproduzieren Sie die Anfrage in Postman anhand der oben beschriebenen Schritte und übernehmen Sie dann das JSON in Ihren Service oder Ihr Automatisierungsmodul, wenn Sie bereit sind, es zu veröffentlichen.