Genel Bakış
API Yanıtlarını Anlamak
ByByBG API, başarılı işlemleri, hataları, yükleme limitlerini ve hız sınırlarını belirtmek için standart HTTP durum kodlarını kullanır.
İpucu:
Kararlı bir kullanıcı deneyimi sağlamak için üretim ortamında her zaman uygun hata yönetimi uygulayın.
STATUS CODES
Yaygın HTTP Durum Kodları
Code
Description
200
Arka plan kaldırma başarıyla tamamlandı.
400
Geçersiz istek veya eksik görsel dosyası.
401
API anahtarı eksik veya geçersiz.
403
Erişim reddedildi.
413
Yüklenen görsel dosyası çok büyük.
415
Desteklenmeyen görsel formatı.
429
Çok fazla istek gönderildi. İstek limiti aşıldı.
500
Sunucuda dahili işleme hatası oluştu.
503
Hizmet geçici olarak kullanılamıyor.
LIMITS
Yükleme Limitleri
- Maksimum görsel boyutu: 10MB
- Desteklenen formatlar: PNG, JPG, JPEG, WEBP
- Şeffaf çıktı formatı: PNG
- API istekleri hız limitlerine tabi olabilir.
- Büyük görsellerin işlenmesi daha uzun sürebilir.
TROUBLESHOOTING
Yaygın Sorunlar ve Çözümler
Geçersiz API Anahtarı
API anahtarınızı ve istek başlıklarını doğrulayın.
Çok Büyük Görsel
Yüklemeden önce görseli sıkıştırın veya yeniden boyutlandırın.
Ağ Hatası
İnternet bağlantınızı ve backend sunucu durumunu kontrol edin.
İstek Limiti Aşıldı
İstek sıklığını azaltın veya planınızı yükseltin.
BEST PRACTICES
Üretim Ortamı İçin En İyi Uygulamalar
- Başarısız istekler için otomatik yeniden deneme mekanizmaları uygulayın.
- Kullanıcılara anlaşılır hata mesajları gösterin.
- Yüklenen dosyaları göndermeden önce doğrulayın.
- Büyük görselleri önceden sıkıştırın.
- Mümkün olduğunda başarılı yanıtları önbelleğe alın.
- API kullanımını ve hız limitlerini izleyin.
ERROR RESPONSE
Örnek Hata JSON Yanıtı
{
"success": false,
"error": "Invalid API key"
}Dokümantasyon Tamamlandı
Artık ByByBG API'sini web sitelerine, mobil uygulamalara, SaaS platformlarına ve otomasyon sistemlerine entegre etmeye hazırsınız.