Stok Medya Arama Kurulumu
Stok-medya arama, Sosyabot medya kütüphanesi ve editöründeki Search Online sekmesini destekler. Üç sağlayıcı desteklenir, her biri kendi API key'i ile bağımsız olarak etkinleştirilir:
- Unsplash (Access Key + Secret Key)
- Pexels (tek API Key)
- Pixabay (tek API Key)
Yalnızca burada yapılandırdığın sağlayıcılar kullanıcı tarafı arama dropdown'unda görünür.
Son-kullanıcı akışı: Dosyalar → Stok Arama.
Genel bakış
| Sağlayıcı | Form alanları | Options anahtarları |
|---|---|---|
| Unsplash | Access Key, Secret Key | unsplash_access-key, unsplash_secret-key |
| Pexels | API Key | pexels_api-key |
| Pixabay | API Key | pixabay_api-key |
Master Status toggle'ı yoktur — her sağlayıcı key'i varsa örtük olarak etkin, boşsa devre dışıdır.
Unsplash
Adım adım
- https://unsplash.com/developers'ta kayıt ol.
- Your apps → New Application. Şartları kabul et.
- App adı ve açıklama ver.
- Yeni app'in sayfası Access Key ve Secret Key'i gösterir. İkisini de kopyala.
Yapıştırma
/admin/api-integration/online-media-search → Unsplash bölümü:
- Access Key: yapıştır.
- Secret Key: yapıştır.
- Save.
Varsayılan rate limit: saatte 50 istek (Demo kademesi). Saatte 5.000 için Unsplash üzerinden Production erişim talep et.
Pexels
Adım adım
- https://www.pexels.com/api/'ta kayıt ol.
- Get Started → Generate API key.
- Gösterilen anahtarı kopyala.
Yapıştırma
/admin/api-integration/online-media-search → Pexels bölümü:
- API Key: yapıştır.
- Save.
Varsayılan rate limit: saatte 200, ayda 20.000 — tipik kullanım için cömert.
Pixabay
Adım adım
- https://pixabay.com/api/docs/'ta kayıt ol.
- Get my API key (giriş sonrası).
- Gösterilen anahtarı kopyala.
Yapıştırma
/admin/api-integration/online-media-search → Pixabay bölümü:
- API Key: yapıştır.
- Save.
Varsayılan rate limit: dakikada 100 (çok cömert). Gösterilen görsellerin hotlink'lenmesi kısıtlıdır; Sosyabot uyum için varlığı indirir ve dosya kütüphanesinde saklar.
Doğrulama
/app/files/search-online → dropdown'dan sağlayıcı seç → bir keyword ara → herhangi bir sonuca tıkla → kullanıcının dosya kütüphanesine indiğini doğrula.
Sorun giderme
| Belirti | Sebep | Çözüm |
|---|---|---|
| Sağlayıcı dropdown'da yok | API key'i boş | Admin formunda anahtarı ekle. |
| Unsplash arama 401 döner | Yanlış Access Key VEYA app Demo limitini aştı | Access Key'i yeniden ver; Production kademesi için başvur. |
| Pexels arama 429 döner | Saatlik rate limit'e ulaşıldı | Bekle — Pexels limit saatlik sıfırlanır. |
| Pixabay sonuç gösterir ama biri seçildiğinde indirme başarısız | Backend'den outbound network sorunu | [backend] log'larını kontrol et; egress kısıtlıysa /admin/data/proxies üzerinden HTTP proxy yapılandır. |
ENV fallback
Stok-medya sağlayıcıları için ENV bloku yoktur — yalnızca admin panel.