API'nin kapsamı

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.

Tipik entegrasyonlar

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.

Uç nokta grupları

Belgelenmiş yöntemlerin özeti.

Hesap

Profil, bakiye ve depolamayı okuyun, bir tarih aralığı için rapor istatistiklerini çekin ve DMCA bildirimlerini listeleyin.

Yükle

Bir yükleme sunucusu isteyin, ardından dosyayı multipart form verisi olarak gönderin ve kodları ile bağlantıları geri alın.

Uzaktan yükleme

URL ekleyin, işleri listeleyin, durum ve yuvaları denetleyin, başarısız aktarımları yeniden başlatın veya silin.

Klasörler

Klasörleri ve içindeki dosyaları oluşturun, yeniden adlandırın ve listeleyin.

Dosya

Dosyaları listeleyin, denetleyin, inceleyin, yeniden adlandırın, taşıyın, kopyalayın, küçük resimlerini alın.

Ara

Videoları arama terimiyle bulun, URL'lerden kapak görseli veya altyazı ekleyin.

İlk çağrınızı yapın

  1. 1Giriş yapın ve API anahtarınızı hesap ayarları sayfasından kopyalayın.
  2. 2Anahtarın çalıştığını doğrulamak ve depolamanızı ile bakiyenizi görmek için hesap bilgisi uç noktasını çağırın.
  3. 3Yükleme sunucusu uç noktasıyla bir yükleme sunucusu isteyin ve döndürdüğü adresi not alın.
  4. 4Dosyayı multipart form verisi olarak o adrese gönderin. Yanıt dosya kodunu, bir izleme bağlantısını ve bir yerleştirme bağlantısını içerir.
  5. 5İşlemenin ne zaman bittiğini görmek için dosya kontrol uç noktasını sorgulayın veya dosyaları listeleyin.

Gerçek uç noktalarla örnekler

curl: hesap bilgisi ve yükleme

İ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"

PHP: URL'den video içe aktarma

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';

JavaScript ile dosya durumu kontrolü

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);

İyi uygulamalar

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.

Uygulamada hata yönetimi

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.

API'nin yapmadıkları

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.

FileHost.net nasıl karşılaştırılır

Entegrasyon için barındırıcı mı seçiyorsunuz? Sundukları imkânları karşılaştırın.

Tüm karşılaştırmalar

İlgili araçlar ve rehberler

Denemek ister misiniz?

Hesap oluşturun, anahtarınızı kopyalayın ve ilk curl komutunu çalıştırın. Aynı öğleden sonra çalışan bir entegrasyonunuz olur.

Sık sorulan sorular

Evet. Her istek, hesap ayarlarınızdan kopyalayabileceğiniz kişisel anahtarınızı kullanır.

Saniyede on istek. Aşılırsa 429 Too Many Requests yanıtı döner.

Evet. Bir yükleme sunucusu adresi isteyin, ardından dosyayı multipart form verisi olarak oraya gönderin.

Evet. URL yükleme uç noktası bir bağlantı alır ve dosya kodu döndürür; klasör ve başlık parametreleri isteğe bağlıdır.

PHP ve Python istemcileri yakında olarak listelenmiştir. Şimdilik HTTP uç noktalarını doğrudan çağırın.