API Belgeleri

API Belgeleri


FileHost.net provides a simple HTTP API to integrate ours into your business or application.
All requests to the API should be only GET or POST
You can find your API key here - https://filehost.net/settings

Hız sınırları

API istekleri saniyede 10 ile sınırlıdır - daha fazlası için bize ulaşın

Yanıt
{"msg":"Too Many Requests","status":"429"}

Hesap

Hesap Bilgisi

Hesabınızın temel bilgilerini alın

GET https://filehost.net/api/account/info?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": {
      "email": "[email protected]",
      "balance": "0.00000",
      "storage_used" :"24186265",
      "storage_left": 128824832615,
      "premim_expire": "2026-03-12 21:00:00
  }
}

Hesap Raporları

Hesabınızın raporlarını alın (varsayılan son 7 gün)

GET https://filehost.net/api/account/stats?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
last
Son x gün raporu
Hayır
from_date
Başlangıç tarihi - YYYY-MM-DD
Hayır
to_date
Bitiş tarihi - YYYY-MM-DD
Hayır
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "profit_views": "0.00000",
      "downloads": "0",
      "views": "0",
      "day": "2026-03-12",
      "profit_total": "0.00000"
    },
    {
      "profit_views": "0.00000",
      "downloads": "0",
      "views": "0",
      "day": "2026-03-12",
      "profit_total": "0.00000"
    }
  ]
}

DMCA Listesi

DMCA bildirilen dosya listesini alın (sayfa başına 500)

GET https://filehost.net/api/dmca/list?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
per_page
Sayfa başına sonuç (varsayılan 500)
hayır
page
Sayfalama
hayır
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "reported_on": "2026-03-12 04:30:07",
      "protected_download": "yyy",
      "protected_embed": "zzz",
      "file_code": "xxx",
      "fld_id": "0",
      "disabled_on": "2026-03-12 05:00:07"
    }
  ]
}

Yükle

Yerel yükleme

API ile yerel dosya yükleyin

GET https://filehost.net/api/upload/server?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "https://filehost.net/api/upload/server/01?key={your_api_key}"
}
Kullanım örneği (cURL)
curl -X POST -F 'api_key={your_api_key}' -F '[email protected]' "https://filehost.net/api/upload/server/01?key={your_api_key}"
Kullanım örneği (HTML)
<form enctype="multipart/form-data" action="https://filehost.net/api/upload/server/01?key={your_api_key}" method="post">
<input type="hidden" name="api_key" value="{your_api_key}">
<input name="file" type="file">
<input type="submit">
</form>
Yükleme sonrası yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "download_url": "https://filehost.net/d/xxx",
      "single_img": "../assets/img/examples/snaps/xxx.jpg",
      "status": 200,
      "filecode": "xxx",
      "splash_img": "../assets/img/examples/splash/xxx.jpg",
      "canplay": 1,
      "size": "123456",
      "length": "123456",
      "uploaded": "2026-03-12 04:30:07",
      "protected_embed": "https://filehost.net/e/yyy",
      "protected_dl": "https://filehost.net/d/zzz",
      "title": "test_file"
    }
  ]
}

Kopyala / Klonla

Kendi veya başkasının dosyasını kopyala / klonla

GET https://filehost.net/api/file/clone?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
file_code
Dosya kodu
Evet
fld_id
Klasör ID'si (klasörün içine kopyalamak için)
Hayır
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": {
    "embed_url": "https://filehost.net/e/xxx",
    "download_url": "https://filehost.net/d/xxx",
    "protected_download": "https://filehost.net/d/yyy",
    "protected_embed": "https://filehost.net/e/zzz",
    "filecode": "xxx"
  }
}

Büyük dosyalar (kaldığı yerden yükleme)

Büyük dosyaları parçalar halinde gönderin. Başarısız bir parça yeniden gönderilir, yarıda kalan bir yükleme de aynı ad, boyut ve değiştirilme zamanıyla yeniden başlattığınızda kaldığı yerden devam eder (48 saat içinde).

POST https://filehost.net/api/uploads/chunked?key={your_api_key}
Parametre
Açıklama
Zorunlu
name
Uzantılı dosya adı
Evet
size
Dosya boyutu (bayt)
Evet
modified
Son değiştirilme zamanı (dosya için hep aynı kalan herhangi bir sayı)
Hayır
folder_id
Klasör ID
Hayır
Yanıt
{
  "status": "ok",
  "upload_id": "up_8fe75a942bd003f06095",
  "chunk_bytes": 8388608,
  "chunk_count": 13,
  "missing": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
}
Sonra missing içindeki her parçayı gönderin, ardından bitirin
# part N = bytes N*chunk_bytes up to (N+1)*chunk_bytes, as the raw request body
curl -X POST --data-binary @part-0.bin -H "Content-Type: application/octet-stream" \
  "https://filehost.net/api/uploads/chunked/{upload_id}/0?key={your_api_key}"

curl -X POST "https://filehost.net/api/uploads/chunked/{upload_id}/complete?key={your_api_key}"
Yükleme sonrası yanıt
{
  "status": "ok",
  "kind": "video",
  "code": "xxx"
}

Uzaktan Yükleme

Link ekle

Doğrudan bağlantılarla dosya yükleyin

GET https://filehost.net/api/upload/url?key={your_api_key}&url={upload_url}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
url
Yüklenecek URL
Evet
fld_id
Bir klasörün içine yüklemek için
Hayır
new_title
Yeni başlık belirle
Hayır
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "new_title": "",
  "status": 200,
  "total_slots": "100",
  "result": {
    "filecode": "98zukoh5jqiw"
  },
  "used_slots": "0"
}

Uzaktan yükleme listesi

Uzaktan yükleme listesi ve durumu

GET https://filehost.net/api/urlupload/list?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "bytes_total": "0",
      "created": "2026-03-12 04:30:07",
      "remote_url": "https://dropbox.com/hukbasd7k3fd",
      "status": "working",
      "file_code": "98zukoh5jqiw",
      "bytes_downloaded": "0",
      "folder_id": "0"
    }
  ]
}

Uzaktan yükleme durumu

Uzaktan Yükleme Durumu

GET https://filehost.net/api/urlupload/status?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
file_code
Dosyanın dosya kodu
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "bytes_total": "0",
      "created": "2026-03-12 04:30:07",
      "remote_url": "https://dropbox.com/hukbasd7k3fd",
      "status": "working",
      "file_code": "hjsnr087johj",
      "bytes_downloaded": "0",
      "folder_id": "0"
    }
  ]
}

Uzaktan yükleme slotları

Toplam ve kullanılan uzaktan yükleme slotları

GET https://filehost.net/api/urlupload/slots?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "total_slots": "100",
  "used_slots": "10"
}

Uzaktan yükleme işlemleri

Uzaktan yükleme üzerinde çeşitli işlemler yapın

GET https://filehost.net/api/urlupload/actions?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
restart_errors
Tüm hataları yeniden dene
Evet
clear_errors
Tüm hataları temizle
Hayır
clear_all
Tümünü temizle
Hayır
delete_code
Aktarımı sil, file_code gönderin
Hayır
Yanıt
{
  "msg": "Errors restarted",
  "server_time": "2026-03-12 04:30:07",
  "status": 200
}

Klasörleri yönet

Klasör oluştur

Klasör oluştur

GET https://filehost.net/api/folder/create?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
name
Klasör adı
Evet
parent_id
Üst klasör ID
Hayır
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": {
    "fld_id": "1234567"
  }
}

Klasörü adlandır

Tüm klasörleri listele

GET https://filehost.net/api/folder/rename?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
fld_id
Klasör ID
Evet
name
Klasörün yeni adı
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

Klasör ve Dosya Listesi

Tüm klasörleri listele

GET https://filehost.net/api/folder/list?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
fld_id
Klasör ID
Evet
only_folders
Yalnızca klasörleri listele (0 veya 1)
Hayır
Yanıt
{
    "msg":"OK",
    "status":200,
    "result":{
        "folders":[
            {
            "name":"Folder name",
            "code":"67299gduj3",
            "fld_id":"123"
            },
        ],
        "files": [
              {
                "download_url": "https://filehost.net/d/xxx",
                "single_img": "../assets/img/examples/snaps/xxx.jpg",
                "file_code": "xxx",
                "canplay": 1,
                "length": "1234",
                "views": "1",
                "uploaded": "2026-03-12 04:30:07",
                "public": "1",
                "fld_id": "0",
                "title": "test_file"
              }
            ],
    },
        "server_time":"2026-03-12 07:31:01"
}

Dosyaları Yönet

Dosya listesi

Tüm dosyaları listele

GET https://filehost.net/api/file/list?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
page
Sayfalama
hayır
per_page
Sayfa başına en fazla video (en çok 200)
hayır
fld_id
Klasördeki videolar
hayır
created
Show files uploaded after timestamp (Ex : 2026-03-12 03:15:19)
Or specify number to show only files uploaded X minutes ago
hayır
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": {
    "total_pages": 1,
    "files": [
      {
        "download_url": "https://filehost.net/d/xxx",
        "single_img": "../assets/img/examples/snaps/xxx.jpg",
        "file_code": "xxx",
        "canplay": 1,
        "length": "1234",
        "views": "1",
        "uploaded": "2026-03-12 04:30:07",
        "public": "1",
        "fld_id": "0",
        "title": "test_file"
      }
    ],
    "results_total": "1",
    "results": 1
  }
}

Dosya durumu

Dosyanızın durumunu kontrol edin

GET https://filehost.net/api/file/check?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
file_code
Dosya kodu
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "status": "Active",
      "filecode": "xxx"
    }
  ]
}

Dosya bilgisi

Dosya bilgisini al

GET https://filehost.net/api/file/info?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
file_code
Dosya kodu
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "single_img": "../assets/img/examples/snaps/xxx.jpg",
      "status": 200,
      "filecode": "xxx",
      "splash_img": "../assets/img/examples/splash/xxx.jpg",
      "canplay": 1,
      "size": "123456",
      "views": "0",
      "length": "123456",
      "uploaded": "2026-03-12 04:30:07",
      "last_view": "",
      "protected_embed": "/e/yyy",
      "protected_dl": "/d/zzz",
      "title": "test_file"
    }
  ]
}

Dosya görseli

Dosya kapağını, tekil veya küçük görseli alın

GET https://filehost.net/api/file/image?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
file_code
Dosya kodu
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "status": 200,
      "filecode": "xxx",
      "title": "test_file",
      "single_img": "../assets/img/examples/snaps/xxx.jpg",
      "thumb_img": "../assets/img/examples/thumbnails/xxx.jpg",
      "splash_img": "../assets/img/examples/splash/xxx.jpg"
    }
  ]
}

Adı değiştirme

Dosyayı yeniden adlandır

GET https://filehost.net/api/file/rename?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
file_code
Dosya kodu
Evet
title
Yeni dosya adı
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

Dosya taşıma

Dosyanızı bir klasörden diğerine taşıyın

GET https://filehost.net/api/file/move?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
file_code
Dosya kodu
Evet
fld_id
Dosyanın taşınacağı klasör ID'si (0 = kök dizin)
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

Dosyalarınızda arayın

GET https://filehost.net/api/search/videos?key={your_api_key}
Parametre
Açıklama
Zorunlu
key
API Anahtarınız
Evet
search_term
Arama terimi
Evet
Yanıt
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

Ekstralar

Uzaktan kapak resmi

Kapak görselini doğrudan URL ile yükle

URL https://filehost.net/e/xxx?c_poster=https://example.com/image.jpg
Parametre
Açıklama
Zorunlu
c_poster
Kapak görseli
Evet

Uzaktan altyazı

Birden çok altyazıyı doğrudan URL ile yükle

URL https://filehost.net/e/xxx?c1_file=https://example.com/sub.vtt&c1_label=English
Parametre
Açıklama
Zorunlu
c1_file
Altyazı URL'si (srt veya vtt)
Evet
c1_label
Altyazı dili veya herhangi bir etiket
Evet

Uzaktan altyazı JSON

Birden çok altyazıyı JSON biçiminde URL ile yükle

URL https://filehost.net/e/xxx?subtitle_json=https://example.com/sub.json
Parametre
Açıklama
Zorunlu
subtitle_json
JSON biçiminde birden çok altyazı
Evet
Uzak altyazı JSON örneği
[
 {"src":"https://example.com/name_en.vtt", "label":"English", default: true},
 {"src":"https://example.com/name_fr.vtt", "label":"French"}
]

Resmi istemciler

Resmi PHP istemcisi

Çok yakında.

Resmi Python istemcisi

Çok yakında.

İletişim

API erişimi ve entegrasyon desteği için [email protected] adresine yazın.