توثيق 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
معرّف المجلد (للنسخ داخله)
لا
الاستجابة
{
  "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"
  }
}

الرفع عن بُعد

إضافة رابط

رفع الملفات عبر روابط مباشرة

GET https://filehost.net/api/upload/url?key={your_api_key}&url={upload_url}
المعامل
الوصف
مطلوب
key
مفتاح API الخاص بك
نعم
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
معرّف المجلد الأصل
لا
الاستجابة
{
  "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
معرّف المجلد
نعم
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
معرّف المجلد
نعم
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
معرّف المجلد لنقل الملف إليه (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 https://filehost.net/e/xxx?c_poster=https://example.com/image.jpg
المعامل
الوصف
مطلوب
c_poster
صورة الغلاف
نعم

ترجمة بعيدة

تحميل عدة ترجمات مباشرة عبر الرابط

URL https://filehost.net/e/xxx?c1_file=https://example.com/sub.vtt&c1_label=English
المعامل
الوصف
مطلوب
c1_file
رابط الترجمة (srt أو vtt)
نعم
c1_label
لغة الترجمة أو أي تسمية
نعم

JSON للترجمة البعيدة

تحميل عدة ترجمات عبر الرابط بصيغة JSON

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].