Arayüz, panelde yapabildiklerinizi yansıtır. Hesap ayrıntılarını ve depolamayı okuyabilir, yükleme sunucusu isteyip dosya gönderebilir, URL'den video içe aktarabilir, dosyaları listeleyip inceleyebilir, taşıyıp yeniden adlandırabilir, klasör oluşturabilir, video arayabilir ve uzaktan yükleme kuyruğunu yönetebilirsiniz. Birkaç ekstra, uzak bir adresten kapak görseli veya altyazı eklemenizi sağlar.
İstekler düz HTTP GET veya POST ile yapılır. API anahtarınız key parametresine yazılır ve hesap ayarlarınızda bulunur. Her yanıt; bir mesaj, bir durum kodu, sunucu saati ve bir sonuç içeren JSON'dur. 429 yanıt durumu, saniyede 10 istek sınırına ulaştığınız anlamına gelir; daha fazlasına ihtiyacınız varsa destekle iletişime geçin.
Derlenmiş videoyu doğrudan bir derleme sunucusundan gönderen yayın iş akışları, bir e-tablodan bağlantı içe aktaran içerik araçları, bir içerik üreticisinin kitaplığını sitede listeleyen eklentiler ve kodlama durumunu izleyen izleme betikleri. Resmi PHP ve Python istemcileri yakında olarak listelenmiştir; bu yüzden şimdilik uç noktaları aşağıda gösterildiği gibi doğrudan çağırırsınız.
Belgelenmiş yöntemlerin özeti.
Profil, bakiye ve depolamayı okuyun, bir tarih aralığı için rapor istatistiklerini çekin ve DMCA bildirimlerini listeleyin.
Bir yükleme sunucusu isteyin, ardından dosyayı multipart form verisi olarak gönderin ve kodları ile bağlantıları geri alın.
URL ekleyin, işleri listeleyin, durum ve yuvaları denetleyin, başarısız aktarımları yeniden başlatın veya silin.
Klasörleri ve içindeki dosyaları oluşturun, yeniden adlandırın ve listeleyin.
Dosyaları listeleyin, denetleyin, inceleyin, yeniden adlandırın, taşıyın, kopyalayın, küçük resimlerini alın.
Videoları arama terimiyle bulun, URL'lerden kapak görseli veya altyazı ekleyin.
İlk çağrı anahtarı kontrol eder. İkincisi, yükleme sunucusu çağrısının döndürdüğü sunucu adresine bir dosya gönderir.
curl "https://filehost.net/api/account/info?key=YOUR_API_KEY"
curl "https://filehost.net/api/upload/server?key=YOUR_API_KEY"
curl -X POST -F 'api_key=YOUR_API_KEY' -F '[email protected]' \
"https://filehost.net/api/upload/server/01?key=YOUR_API_KEY"Bir uzaktan yükleme işi ekler ve dosya kodunu yazdırır. Kaynak adreste urlencode kullanın.
<?php
$key = 'YOUR_API_KEY';
$src = urlencode('https://example.com/video.mp4');
$res = json_decode(file_get_contents(
"https://filehost.net/api/upload/url?key=$key&url=$src"
), true);
echo $res['result']['filecode'] ?? 'failed';Anahtarı sunucu tarafında tuttuğunuz sürece Node 18 veya üzerinde ve tarayıcıda çalışır.
const key = process.env.FILEHOST_KEY;
const code = 'FILE_CODE';
const r = await fetch(
`https://filehost.net/api/file/check?key=${key}&file_code=${code}`
);
const data = await r.json();
console.log(data.result[0].status);Anahtarı istemci tarafı kodunun dışında tutun; çünkü onu gören herkes hesabınız gibi işlem yapabilir. Çağrıları kuyruğa alarak ve 429 yanıtında geri çekilerek saniyede 10 istek sınırına uyun. Yüklemenin döndürdüğü dosya kodunu saklayın; çünkü diğer tüm çağrılar bir dosyaya bu kodla başvurur.
Büyük yüklemeler en iyi, bağlantısı kararlı bir sunucudan gönderilir. Zaten çevrimiçi olan dosyalar için sunucu bağlantısını kullanan ve bir iş koduyla anında dönen URL içe aktarmayı tercih edin.
Hem HTTP durumunu hem de JSON gövdesindeki status alanını kontrol edin ve genellikle neyin ters gittiğini açıklayan mesaj metnini günlüğe kaydedin. Eksik dosya kodunu veya süresi dolmuş anahtarı kesin hata, 429 yanıtını ise bekleyip yeniden deneme işareti olarak değerlendirin. Toplu işler hazırlarken, çöken bir betiğin hiçbir şeyi iki kez yüklemeden devam edebilmesi için dönen her dosya kodunun yerel bir kaydını tutun.
Belgelenmiş bir webhook geri çağrısı yoktur, bu yüzden tamamlanma durumu yoklama (polling) ile kontrol edilir. Belgelenmiş yükleme yanıtı dosya kodunu ve bağlantıları verir; resmî istemci kitaplıkları henüz yayınlanmadı. Eksik bir özelliğe ihtiyacınız varsa iletişim sayfası üzerinden desteğe bildirin.
Entegrasyon için barındırıcı mı seçiyorsunuz? Sundukları imkânları karşılaştırın.
Hesap oluşturun, anahtarınızı kopyalayın ve ilk curl komutunu çalıştırın. Aynı öğleden sonra çalışan bir entegrasyonunuz olur.