Ana içeriğe geç

Görüntü Sıkıştırma API'si: Daha Küçük JPG'ler İçin Adım Adım Postman Testi

· 10 dakikalık okuma
SEO and Content Writer

Büyük boyutlu görseller sayfaları yavaşlatır, bant genişliği faturalarını şişirir ve performansa engel olur. Temel Web Ölçütleri: özellikle En Büyük İçerikli Boya (LCP) Büyük bir fotoğrafın ana unsur olduğu durumlarda. görüntü sıkıştırma API'si Bu özellik, JPG/PNG dosyalarını elle düzeltmek yerine, işlem hattında (yükleme işleyicileri, CMS içe aktarmaları, DAM iş akışları) küçültmenizi sağlar.

Bu kılavuz şu yöntemleri kullanmaktadır: PDF4me POST /api/v2/CompressImage ile Postacıİstek şekli netleştikten sonra aynı yöntem kodda da işe yarar. Örneğin: kodsuz ilk testetkileşimli olanı kullanın Görüntü Sıkıştırma API Test CihazıBu yöntem, ham JSON yerine form alanlarıyla aynı uç noktaya istek gönderir.

Bu kılavuzu nasıl okuyabilirsiniz?
  • Adımları takip edin 1 → 5Ekran görüntüleri gerçek bir çalıştırmayı yansıtır (zamanlamalarınız ve bayt sayılarınız görüntü içeriğine ve ağa bağlı olarak değişebilir).
  • Postacı yer tutucusunu değiştirin. {{BASE64_OF_INPUT_IMAGE}} Base64 ile senin dosya, hayır veri:image/jpe;base64, JSON dizesindeki önek.
  • Başarılı bir görüşmenin ardından, gelen yanıtı çözümleyin. .jpg ve karşılaştırın Explorer'daki dosya boyutu (veya macOS Finder) aracılığıyla orijinaline geri dönün.
kısa versiyon

1. Resminizi Base64 olarak kodlayın → 2. POSTALAMAK https://api.pdf4me.com/api/v2/CompressImage ile İçerik Türü: application/json Ve Yetkilendirme (PDF4me API anahtarınız) → 3. JSON gövdesi: belge içeriği, belge adı, resimTürü, sıkıştırma seviyesi, asenkron4. Beklemek 200 Tamam ve bir JPEG verisi (istemcinizin nasıl görüntülediğine bağlı olarak ham baytlar veya Base64) → 5. Disk boyutunu kaynak dosyayla kaydedin ve karşılaştırın.

Ekipler neden görüntü sıkıştırma API'si kullanıyor (piyasa bağlamı)?

ÖncelikAPI ile neler değişir?
Web performansıDaha küçük boyutlu görüntüler daha hızlı çözümlenir ve daha hızlı aktarılır; bu da LCP'nin tek bir büyük varlığa bağlı olduğu durumlarda önemlidir.
Kullanıcı deneyimiGörseller daha açık renkli olduğunda, mobil cihazlarda sayfalar daha güvenilir bir şekilde yüklenir ve etkileşim süresi daha kısa olur.
OperasyonlarMikro hizmetler, sunucusuz yükleme işleyicileri ve ETL işlemleri için tek bir HTTP sözleşmesi; döngüde masaüstü araçlarına gerek yok.
MaliyetÇok MB'lık orijinal dosyaları her yerde sunmaya kıyasla daha az erişim ve depolama alanı.

PDF4me ifşa ediyor sıkıştırma seviyeleri (Maksimum, Orta, DüşükBöylece küçük resimlerle ana görselleri eşleştirebilirsiniz. Parametre genel bakışına bakın. Görüntüyü Sıkıştır (tam API referansı) ve aşağıdaki kısa tablo.

İlk talebi göndermeden önce

Kontrol listesi
  1. API anahtarı: -den PDF4me kontrol paneli (kullanıldığı yer) Yetkilendirme başlık başına resmi belgeler).
  2. Giriş formatı: JPG veya PNG (bkz. API Testleri (parametre notları).
  3. Büyük dosyalar / zaman aşımı: ayarlamak "asenkron": doğru önerildiğinde veya ön işlemden geçirerek Görüntüyü yeniden boyutlandır Piksel sayısı ekran boyutunu çok aşarsa.
  4. Kota: Kimlik doğrulama başarısız oldu veya plan sınırları aşıldı, kullanın PDF4me sorun giderme 401/402 tarzı hatalar görürseniz.

Referans: JSON gövde alanları

AlanRol
belge içeriğiKaynak görüntünün Base64 kodu (zorunlu).
belge adıÇıktı dosya adı, örneğin: çıktı.jpg (gerekli).
resimTürüÇıktı formatı, örneğin: JPG veya PNG.
sıkıştırma seviyesiMaksimum, Orta, veya Düşük.
asenkrondoğru / YANLIŞİstemci zaman aşımını aşabilecek işlem sürelerinde eşzamansız (async) işlem kullanın.

Adım 1: Gerçek bir "öncesi" dosyasından başlayın.

Pratik yapmak için büyük boyutlu herhangi bir JPG dosyası kullanabilirsiniz. Aşağıdaki referans çalışmasında büyük boyutlu bir JPG kullanılmıştır. ~4,5 MB kaynak dosya adı giriş.jpg Windows Gezgini'nde, klasör özelliklerinde sıkıştırmanın gözle görülür şekilde anlamlı olacağı kadar büyük.

Windows Gezgini, sıkıştırma API'sini çağırmadan önce büyük bir JPG giriş dosyasını (~4,48 MB) gösteriyor.

Adım 2: Postman isteğini yapılandırın (yöntem + URL)

Açın Başlıklar Sekme. En azından şunlara ihtiyacınız var: Content-Type: application/json ve PDF4me anahtarınızı girin Authorization (Ekran görüntüsündeki yer tutucuyu gerçek anahtarınızla değiştirin).

Postman'de Görüntüyü Sıkıştır özelliği için Başlıklar sekmesi: POST URL'si ve Yetkilendirme

Adım 3: Ham JSON gövdesini ayarlayın

Seçmek Gövde → ham → JSONArdından, şu şekilde bir veri paketi yapıştırın (Base64 dizenizi buraya yazın).

Postman Gövde sekmesi, docContent, docName, imageType, compressionLevel ve async alanlarını içerir.

{
"docContent": "PASTE_BASE64_HERE_NO_DATA_URL_PREFIX",
"docName": "output.jpg",
"imageType": "JPG",
"compressionLevel": "Max",
"async": false
}
İsteğe bağlı: Gönder'e tıklamadan önce minimum düzeyde doğrulama kontrolleri yapılır.
  • JPEG Base64 genellikle şununla başlar: /9j/ Araç, JPEG dosya imzasına karşılık gelen metin biçimini gösterdiğinde.
  • Postman yavaş çalışıyorsa, istek yine de başarılı olabilir, dikkatli olun. 200 Tamam ve çıktıyı kaydedin; dikkate alın asenkron: doğru Üretim toplu işleri için.
  • JSON yerine yönlendirmeli bir form için, açın. API Test Cihazında Görüntüyü Sıkıştır ve aynı alanları yan yana karşılaştırın.

Adım 4: Yanıtı gönderin ve okuyun

İstemci Base64'ü gösterdiğinde

Eğer Vücut izleyici ayarlandı Base64 ve uzun bir sıra görüyorsunuz, şuradan başlayarak: /9j/Veri yükü, görüntülenmek üzere kodlanmış JPEG verisidir. Kaliteyi doğrulamak için dosyayı çözün ve bir resim görüntüleyici programında açın.

Postman 200, yanıt gövdesi Base64 JPEG olarak yorumlandığında başarılı oldu.

İstemci ham ikili veriyi gösterdiğinde

Bazı görünümler oluşturulur çiğ bayt (XMP gibi meta veriler, akış içinde okunabilir metin olarak görünebilir). A 200 Tamam Bu, sıkıştırılmış görüntünün geri döndürüldüğü anlamına gelir, gövdeyi şu şekilde kaydedin: çıktı.jpg Müşterinizin "Yanıtı kaydet" seçeneğini kullanarak.

Postman 200, ham yanıt gövdesiyle (ikili / meta veriler görünür) sorunsuz çalışıyor.

Adım 5: Disk üzerindeki "sonraki" dosya boyutunu karşılaştırın.

Yanıtı diske yazdıktan sonra kontrol edin. Özellikler Tekrar. Referans çalıştırmada, sıkıştırılmış dosya yakına indi. ~2,6 MBÇok megabaytlık bir fotoğrafta iş akışını basit tutarken kullanışlı bir boyut küçültme yöntemi. Oranınız içeriğe, boyutlara ve sıkıştırma seviyesi; denemek Orta veya Düşük eğer Maksimum Ürün fotoğrafları için fazla agresif.

Windows Gezgini, API çağrısından sonra sıkıştırılmış output.jpg dosyasının boyutunu gösteriyor.

Sorun giderme (hızlı)

401 / kimlik doğrulama hataları

Anahtarı onaylayın Yetkilendirme ve anahtarın aktif olduğunu gösterir. Bakınız. API dokümanları Ve sorun giderme.

Zaman aşımı veya çok yavaş aramalar

Denemek "asenkron": doğru Desteklenen yerlerde veya önce piksel boyutlarını küçültün. Görüntüyü yeniden boyutlandır.

"Bozuk" veya boş çıktı

Şerit veri:resim/...;base64, ön eklerden belge içeriğiBase64 dizesindeki satır sonlarını kaldırın ve kaynak dosyanın yerel olarak açıldığını doğrulayın.

Postman olmadan otomasyon

İlgili okuma

Özet: Bir görüntü sıkıştırma API'si Duyarlı görseller ve CDN önbellekleme ile aynı araç kutusunda yer alır: kaynakta bayt sayısını azaltarak her sonraki adımı daha ucuz ve daha hızlı hale getirir. Bununla başlayın. API Test CihazıYukarıdaki adımları kullanarak Postman'de isteği yeniden oluşturun, ardından gönderime hazır olduğunuzda JSON'u hizmetinize veya otomasyon modülünüze aktarın.