API Dokümantasyonu

Squezzly'nin güçlü dosya optimizasyon teknolojisini doğrudan uygulamalarınıza entegre edin

Başlarken

Squezzly API'sine hoş geldiniz! API'miz, web platformumuzda kullandığımız aynı güçlü sıkıştırma teknolojisi ile görsel ve belgeleri programatik olarak optimize etmenizi sağlar.

Not: API erişimi şu anda beta aşamasındadır. API anahtarınızı almak için lütfen bizimle iletişime geçin veya Pro plana yükseltin.

Kimlik Doğrulama

Tüm API istekleri, Authorization başlığında API anahtarınızı içermelidir:

Authorization: Bearer API_ANAHTARINIZ

API anahtarınızı güvende tutun ve asla istemci tarafı kodunda kullanmayın.

Yükleme Uç Noktası

POST/api/compress

Başlıklar

Authorization: Bearer <API_ANAHTARI>
Content-Type: multipart/form-data

İstek Gövdesi

ParametreTipZorunluAçıklama
fileDosyaEvetOptimize edilecek dosya
qualitySayıHayırKalite seviyesi (10-100, varsayılan: 80)
formatMetinHayırÇıktı formatı (jpeg, png, webp, avif)

Desteklenen Dosya Türleri

JPEG
PNG
WebP
AVIF
PDF
GIF
SVG

Her format, dosya boyutu ve kalite arasında en iyi dengeyi sağlamak için endüstri lideri sıkıştırma algoritmaları kullanılarak optimize edilir.

Kod Örnekleri

Squezzly API'sini farklı programlama dillerinde nasıl kullanacağınıza dair örnekler:

curl -X POST https://api.squezzly.com/api/compress \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/dosya/yolu/resim.jpg" \
  -F "quality=85" \
  -F "format=webp"

Yanıt Formatı

Başarılı API çağrıları aşağıdaki yapıda bir JSON yanıtı döndürür:

{
  "success": true,
  "fileUrl": "https://squezzly.com/files/optimized-image.webp",
  "originalSize": "2.3MB",
  "optimizedSize": "640KB",
  "compressionRatio": "72%",
  "processingTime": "1.2s"
}

Yanıt Alanları

  • success: İşlemin başarılı olup olmadığını gösteren boolean değer
  • fileUrl: Optimize edilmiş dosyayı indirmek için URL
  • originalSize: Orijinal dosya boyutu
  • optimizedSize: Optimize edilmiş dosya boyutu
  • compressionRatio: Boyut azaltma yüzdesi
  • processingTime: Dosyayı işleme süresi

Güvenlik ve Sınırlar

Hız Sınırlaması

Mevcut Sınırlar:

  • • Dakikada 10 istek
  • • Günde 1000 istek
  • • Maksimum dosya boyutu: 50MB

En İyi Uygulamalar

  • ✓ API'ye göndermeden önce dosya türlerini her zaman doğrulayın
  • ✓ Başarısız istekler için uygun hata yönetimi uygulayın
  • ✓ Mümkün olduğunda optimize edilmiş görselleri önbelleğe alın
  • ✓ Kullanım durumunuz için uygun kalite ayarlarını kullanın
  • ✓ API anahtarınızı asla istemci tarafı kodunda kullanmayın

Hata Kodları

KodAçıklama
400Hatalı İstek - Geçersiz parametreler
401Yetkisiz - Geçersiz API anahtarı
413Dosya çok büyük
429Çok fazla istek
500Sunucu hatası

Başlamaya hazır mısınız?

API anahtarınızı almak ve dosyaları programatik olarak optimize etmeye başlamak için Pro hesaba kaydolun.

Fiyatlandırma Planlarını Görüntüle