API دستاویزات

API دستاویزات


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

ریٹ لمٹس

API درخواستوں کی حد 10 فی سیکنڈ ہے - مزید درخواستوں کے لیے ہم سے رابطہ کریں

جواب
{"msg":"Too Many Requests","status":"429"}

اکاؤنٹ

اکاؤنٹ کی معلومات

اپنے اکاؤنٹ کی بنیادی معلومات حاصل کریں

GET https://filehost.net/api/account/info?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
جواب
{
  "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
  }
}

اکاؤنٹ رپورٹس

اپنے اکاؤنٹ کی رپورٹس حاصل کریں (ڈیفالٹ آخری 7 دن)

GET https://filehost.net/api/account/stats?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
last
آخری x دن کی رپورٹ
نہیں
from_date
شروع تاریخ - YYYY-MM-DD
نہیں
to_date
آخری تاریخ - YYYY-MM-DD
نہیں
جواب
{
  "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 فہرست

DMCA رپورٹ شدہ فائلوں کی فہرست حاصل کریں (فی صفحہ 500 نتائج)

GET https://filehost.net/api/dmca/list?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
per_page
فی صفحہ نتائج (ڈیفالٹ 500)
نہیں
page
صفحہ بندی
نہیں
جواب
{
  "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"
    }
  ]
}

اپ لوڈ

لوکل اپ لوڈ

API سے لوکل فائلیں اپ لوڈ کریں

GET https://filehost.net/api/upload/server?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "https://filehost.net/api/upload/server/01?key={your_api_key}"
}
استعمال کی مثال (cURL)
curl -X POST -F 'api_key={your_api_key}' -F '[email protected]' "https://filehost.net/api/upload/server/01?key={your_api_key}"
استعمال کی مثال (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>
اپ لوڈ کے بعد جواب
{
  "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"
    }
  ]
}

کاپی یا کلون

اپنی یا کسی اور کی فائل کاپی / کلون کریں

GET https://filehost.net/api/file/clone?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
file_code
فائل کوڈ
ہاں
fld_id
فولڈر ID (فولڈر کے اندر کاپی کرنے کے لیے)
نہیں
جواب
{
  "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"
  }
}

بڑی فائلیں (بحال ہونے والی اپ لوڈ)

بڑی فائلیں حصوں میں بھیجیں۔ ناکام حصہ دوبارہ بھیج دیا جاتا ہے، اور رکی ہوئی اپ لوڈ اسی نام، سائز اور ترمیم کے وقت کے ساتھ دوبارہ شروع کرنے پر وہیں سے جاری رہتی ہے جہاں رکی تھی (48 گھنٹوں کے اندر)۔

POST https://filehost.net/api/uploads/chunked?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
name
ایکسٹینشن کے ساتھ فائل کا نام
ہاں
size
فائل کا سائز (بائٹس میں)
ہاں
modified
آخری ترمیم کا وقت (کوئی بھی نمبر جو فائل کے لیے وہی رہے)
نہیں
folder_id
فولڈر ID
نہیں
جواب
{
  "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]
}
پھر missing میں درج ہر حصہ بھیجیں، اس کے بعد مکمل کریں
# 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}"
اپ لوڈ کے بعد جواب
{
  "status": "ok",
  "kind": "video",
  "code": "xxx"
}

ریموٹ اپ لوڈ

لنک ڈالیں

ڈائریکٹ لنکس سے فائلیں اپ لوڈ کریں

GET https://filehost.net/api/upload/url?key={your_api_key}&url={upload_url}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
url
اپ لوڈ کا URL
ہاں
fld_id
فولڈر کے اندر اپ لوڈ کرنے کے لیے
نہیں
new_title
نیا عنوان سیٹ کرنے کو
نہیں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "new_title": "",
  "status": 200,
  "total_slots": "100",
  "result": {
    "filecode": "98zukoh5jqiw"
  },
  "used_slots": "0"
}

ریموٹ اپ لوڈ فہرست

ریموٹ اپ لوڈ فہرست اور حالت

GET https://filehost.net/api/urlupload/list?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
جواب
{
  "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"
    }
  ]
}

ریموٹ اپ لوڈ کی حالت

ریموٹ اپ لوڈ کی حالت

GET https://filehost.net/api/urlupload/status?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
file_code
فائل کا فائل کوڈ
ہاں
جواب
{
  "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"
    }
  ]
}

ریموٹ اپ لوڈ سلاٹس

ریموٹ اپ لوڈ کے کل اور استعمال شدہ سلاٹس

GET https://filehost.net/api/urlupload/slots?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "total_slots": "100",
  "used_slots": "10"
}

ریموٹ اپ لوڈ کارروائیاں

ریموٹ اپ لوڈ پر مختلف کارروائیاں کریں

GET https://filehost.net/api/urlupload/actions?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
restart_errors
تمام ایررز ری اسٹارٹ کریں
ہاں
clear_errors
تمام ایررز صاف کریں
نہیں
clear_all
سب صاف کریں
نہیں
delete_code
ٹرانسفر حذف کریں، file_code دیں
نہیں
جواب
{
  "msg": "Errors restarted",
  "server_time": "2026-03-12 04:30:07",
  "status": 200
}

فولڈر مینیج کریں

فولڈر بنائیں

فولڈر بنائیں

GET https://filehost.net/api/folder/create?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
name
فولڈر کا نام
ہاں
parent_id
پیرنٹ فولڈر ID
نہیں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": {
    "fld_id": "1234567"
  }
}

فولڈر کا نام بدلیں

تمام فولڈرز دکھائیں

GET https://filehost.net/api/folder/rename?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
fld_id
فولڈر ID
ہاں
name
فولڈر کا نیا نام
ہاں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

فولڈرز اور فائلوں کی فہرست

تمام فولڈرز دکھائیں

GET https://filehost.net/api/folder/list?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
fld_id
فولڈر ID
ہاں
only_folders
صرف فولڈرز کی فہرست کے لیے (0 یا 1)
نہیں
جواب
{
    "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"
}


فائلوں کا انتظام

فائل فہرست

تمام فائلیں دکھائیں

GET https://filehost.net/api/file/list?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
page
صفحہ بندی
نہیں
per_page
فی صفحہ ویڈیوز (زیادہ سے زیادہ 200)
نہیں
fld_id
فولڈر کے اندر ویڈیوز
نہیں
created
Show files uploaded after timestamp (Ex : 2026-03-12 03:15:19)
Or specify number to show only files uploaded X minutes ago
نہیں
جواب
{
  "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
  }
}

فائل کی حالت

اپنی فائل کی حالت دیکھیں

GET https://filehost.net/api/file/check?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
file_code
فائل کوڈ
ہاں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": [
    {
      "status": "Active",
      "filecode": "xxx"
    }
  ]
}

فائل معلومات

فائل کی معلومات لیں

GET https://filehost.net/api/file/info?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
file_code
فائل کوڈ
ہاں
جواب
{
  "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"
    }
  ]
}

فائل کی تصویر

فائل کی اسپلیش، سنگل یا تھمب نیل تصویر حاصل کریں

GET https://filehost.net/api/file/image?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
file_code
فائل کوڈ
ہاں
جواب
{
  "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"
    }
  ]
}

فائل ری نیم

فائل کا نام بدلیں

GET https://filehost.net/api/file/rename?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
file_code
فائل کوڈ
ہاں
title
فائل کا نیا نام
ہاں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

فائل منتقلی

اپنی فائل ایک فولڈر سے دوسرے میں منتقل کریں

GET https://filehost.net/api/file/move?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
file_code
فائل کوڈ
ہاں
fld_id
فائل منتقل کرنے کے لیے فولڈر ID (روٹ کے لیے 0)
ہاں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

اپنی فائلیں تلاش کریں

GET https://filehost.net/api/search/videos?key={your_api_key}
پیرامیٹر
تفصیل
لازمی
key
آپ کی API کلید
ہاں
search_term
تلاش کا لفظ
ہاں
جواب
{
  "msg": "OK",
  "server_time": "2026-03-12 04:30:07",
  "status": 200,
  "result": "true"
}

اضافی

ریموٹ اسپلیش امیج

اسپلیش امیج براہِ راست URL سے لوڈ کریں

URL https://filehost.net/e/xxx?c_poster=https://example.com/image.jpg
پیرامیٹر
تفصیل
لازمی
c_poster
اسپلیش امیج
ہاں

ریموٹ سب ٹائٹل

متعدد سب ٹائٹلز براہِ راست URL سے لوڈ کریں

URL https://filehost.net/e/xxx?c1_file=https://example.com/sub.vtt&c1_label=English
پیرامیٹر
تفصیل
لازمی
c1_file
سب ٹائٹل URL (srt یا vtt)
ہاں
c1_label
سب ٹائٹل کی زبان یا کوئی لیبل
ہاں

ریموٹ سب ٹائٹل JSON

JSON فارمیٹ میں URL سے متعدد سب ٹائٹلز لوڈ کریں

URL https://filehost.net/e/xxx?subtitle_json=https://example.com/sub.json
پیرامیٹر
تفصیل
لازمی
subtitle_json
JSON فارمیٹ میں متعدد سب ٹائٹلز
ہاں
ریموٹ سب ٹائٹل JSON مثال
[
 {"src":"https://example.com/name_en.vtt", "label":"English", default: true},
 {"src":"https://example.com/name_fr.vtt", "label":"French"}
]

آفیشل کلائنٹس

سرکاری PHP کلائنٹ

جلد آ رہا ہے۔

سرکاری Python کلائنٹ

جلد آ رہا ہے۔

رابطہ

API تک رسائی اور انضمام میں مدد کے لیے [email protected] سے رابطہ کریں۔