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:
API anahtarınızı güvende tutun ve asla istemci tarafı kodunda kullanmayın.
Yükleme Uç Noktası
/api/compress
Başlıklar
İstek Gövdesi
Parametre | Tip | Zorunlu | Açıklama |
---|---|---|---|
file | Dosya | Evet | Optimize edilecek dosya |
quality | Sayı | Hayır | Kalite seviyesi (10-100, varsayılan: 80) |
format | Metin | Hayır | Çıktı formatı (jpeg, png, webp, avif) |
Desteklenen Dosya Türleri
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ı
Kod | Açıklama |
---|---|
400 | Hatalı İstek - Geçersiz parametreler |
401 | Yetkisiz - Geçersiz API anahtarı |
413 | Dosya çok büyük |
429 | Çok fazla istek |
500 | Sunucu 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