Hızlı Başlangıç Kılavuzu
5 dakikadan kısa sürede görselleri sıkıştırmaya ve sayfa yükleme hızını artırmaya başlayın.
Görsel varlıklarınızı optimize edin ve Core Web Vitals (LCP ve CLS) metriklerinizi sadece 4 kolay adımda iyileştirin.
4 Adımda Başlangıç
Adım 1: API Anahtarınızı Alın
E-posta ile şifresiz OTP doğrulaması kullanarak SmallPict Kontrol Paneli'ne giriş yapın. API Keys bölümünde yeni bir anahtar oluşturun:
- Canlı ortamlar için
sp_live_...kullanın. - Yerel testler ve otomatik CI/CD süreçleri için
sp_test_...kullanın.
Adım 2: Entegrasyon Yönteminizi Seçin
Seçenek A: WordPress
Resmi eklentiyi WordPress dizininden yükleyin veya ZIP dosyasını yükleyin. sp_wp_... anahtarınızı Ayarlar > SmallPict bölümüne yapıştırın ve otomatik WebP/AVIF dönüştürmeyi etkinleştirin.
Seçenek B: Backend veya Frontend SDK
Kullandığınız programlama diline uygun resmi kütüphaneyi yükleyin:
# Node.js & TypeScriptnpm install @smallpict/sdk
# Golanggo get github.com/smallpict/smallpict-go
# Pythonpip install smallpict
# PHP (Composer)composer require smallpict/smallpict-php
# Rust (Cargo)cargo add smallpict
# Ruby (Bundler)gem install smallpictAdım 3: İlk Optimizasyonunuzu Gerçekleştirin
API bağlantınızı doğrulamak için şu cURL komutunu çalıştırın:
curl -X POST https://api.smallpict.app/v1/optimize \ -H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \ -H "X-Timestamp: 1716301234" \ -H "X-Signature: 3a9f8b2c4d6e8a..." \ -H "Content-Type: application/json" \ -d { "filename": "hero.jpg", "mime_type": "image/jpeg", "filesize": 2508800, "options": { "format": "avif", "quality": 80, "max_width": 1920 }}'Adım 4: Sonucu Doğrulayın
API, optimize edilmiş görsel URL'sini ve elde edilen tasarruf oranını içeren bir JSON yanıtı döndürür:
{ "success": true, "data": { "job_id": "job_9a8b7c6d5e4f", "status": "completed", "original_size": 2508800, "optimized_size": 312400, "savings_percentage": 87.54, "format": "avif", "url": "https://cdn.smallpict.app/media/hero.avif" }}Önerilen Varsayılan Yapılandırma
| Parametre | Önerilen Değer | Gerekçe |
|---|---|---|
| Kalite | 80 | Görsel netlik ve dosya boyutu tasarrufu arasında ideal denge. |
| Format | avif (yedek webp) | Modern tarayıcılarda maksimum sıkıştırma ve evrensel uyumluluk. |
| Maksimum Genişlik | 1920px | Ham kamera çekimlerinin mobil veri bağlantılarını tıkamasını önler. |
| EXIF Temizleme | true | Gizliliği korumak ve ek bayt tasarrufu sağlamak için kamera verilerini siler. |