انتقل إلى المحتوى
الرئيسية / Kit / الملفات
Filesالملفات

كل ملف هو عنوان URL

واجهة HTTP واحدة للتخزين المحلي و60+ مزوداً سحابياً — Google Drive وS3 وDropbox والمزيد. بدون SDK، بدون مكتبات.

hoody-files · وصول تخزين عالمي

# Google Drive

$ curl /api/v1/files/Work/report.pdf \

?backend=backend_drive_abc

# Amazon S3

$ curl /api/v1/files/backups/data.zip \

?backend=backend_s3_xyz

# Dropbox

$ curl /api/v1/files/Photos/vacation.jpg \

?backend=backend_dropbox_123

# نفس نمط URL

HTTP/1.1 200 OK

Content-Type: application/pdf

Content-Length: 524288

# تخزين مختلف

HTTP/1.1 200 OK

Content-Type: application/zip

ETag: "a3f2bc..."

نفس نمط URL. تخزين مختلف. بلا تعقيد.

الرئيسية / Kit / الملفات / الخلفيات
60+ مزوداً

اتصل بأي تخزين، فوراً

حمّل Google Drive وS3 وDropbox و60+ مزوداً. مصادقة واحدة لكل خلفية، ثم اوصل إليها عبر أي عنوان URL.

Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
الرئيسية / Kit / الملفات / البروتوكولات
بروتوكولات الملفات

يتحدث كل بروتوكول تخزين

FTP وSFTP وSMB وWebDAV وHTTP وHDFS — حمّل التخزين الشبكي باستخدام أي بروتوكول تدعمه بنيتك التحتية.

FTPالمنفذ 21
SFTPالمنفذ 22
SMBالمنفذ 445
WebDAVNextcloud / SharePoint
HTTPخوادم ملفات الويب
HDFSمجموعات Hadoop
الرئيسية / Kit / الملفات / القدرات
القدرات

أكثر من مجرد استضافة ملفات

بثّ، هاش، معاينة، ضغط، سجّل، وعالج الصور — كل ذلك عبر واجهة HTTP واحدة تعمل عبر جميع الخلفيات.

قراءة وبث

بثّ أي ملف عبر HTTP من التخزين المحلي أو أي خلفية سحابية. يدعم HTML وJSON والتنزيل المباشر.

GET /api/v1/files/[path]

سلامة SHA256

احسب هاشات SHA256 أو MD5 دون تنزيل الملف كاملاً. ضروري لنشر الإنتاج والتحقق من البيانات.

GET /api/v1/files/[path]?hash

معاينة الأرشيف

افحص محتويات .tar.gz و.zip دون استخراج الأرشيف. سرد الإدخالات والأحجام والمسارات في ثانية.

GET /[path]?preview

المجلد كـ .zip

حمّل أي مجلد كأرشيف .zip عند الطلب. يعمل للتخزين المحلي والخلفيات السحابية البعيدة.

GET /[path]?zip

سجل الملفات والمحفوظات

كل تغيير يُسجَّل مع لقطة blob قابلة للعنونة بالمحتوى. اقرأ أي ملف في أي مراجعة سابقة.

GET /api/v1/files/[path]?history

معالجة الصور

تغيير الحجم الفوري، تحويل الصيغة، الضبابية، وتدرج الرمادي لـ JPEG وPNG وWebP وGIF وBMP.

GET /[image]?thumbnail&width=400
الرئيسية / Kit / الملفات / API
مرجع API

21 نقطة نهاية. واجهة واحدة.

قراءة، كتابة، إدارة الخلفيات، ومراقبة السجل — كل شيء مكشوف كـ HTTP عادي. لا يلزم SDK.

قراءة وتنزيل

[count, plural, zero [لا نقاط نهاية] one [# نقطة نهاية] two [# نقطة نهاية] few [# نقاط نهاية] many [# نقطة نهاية] other [# نقطة نهاية]]'

curl .../api/v1/files/Work/report.pdf?backend=backend_drive

GET
/api/v1/files/[path]قراءة أو تنزيل محتوى الملف
GET
/[path]بديل بصيغ HTML/JSON/بسيطة
HEAD
/api/v1/files/[path]الحصول على بيانات وصفية دون التنزيل
GET
/api/v1/files/[path]?hashالحصول على هاش SHA256 للملف
GET
/[path]?previewمعاينة محتويات الأرشيف (tar.gz، zip)
GET
/[path]?zipتنزيل المجلد كأرشيف .zip

كتابة وتعديل

[count, plural, zero [لا نقاط نهاية] one [# نقطة نهاية] two [# نقطة نهاية] few [# نقاط نهاية] many [# نقطة نهاية] other [# نقطة نهاية]]'

POST .../api/v1/files/copy/[path]?copy_to=/backup/

PUT
/[path]رفع ملف إلى تخزين الخادم
POST
/api/v1/files/[path]عمليات الملفات: mkdir، استخراج، نقل، نسخ
POST
/api/v1/files/copy/[path]نسخ ملف أو مجلد إلى موقع جديد
POST
/api/v1/files/move/[path]نقل أو إعادة تسمية ملف إلى مسار جديد
DELETE
/[path]حذف ملف أو مجلد
GET
/[directory]?qالبحث عن ملفات مطابقة للاستعلام

إدارة الخلفيات

[count, plural, zero [لا نقاط نهاية] one [# نقطة نهاية] two [# نقطة نهاية] few [# نقاط نهاية] many [# نقطة نهاية] other [# نقطة نهاية]]'

POST .../api/v1/backends/drive → [id: "backend_drive_abc"]

POST
/api/v1/backends/[type]تحميل خلفية تخزين
GET
/api/v1/backendsسرد جميع الخلفيات المحمّلة
GET
/api/v1/backends/[id]الحصول على تفاصيل الخلفية
GET
/api/v1/backends/[id]/testاختبار اتصال الخلفية
DELETE
/api/v1/backends/[id]فصل الخلفية

النظام والسجل

[count, plural, zero [لا نقاط نهاية] one [# نقطة نهاية] two [# نقطة نهاية] few [# نقاط نهاية] many [# نقطة نهاية] other [# نقطة نهاية]]'

GET .../api/v1/journal?path=src/&op=write

GET
/__hoody-files__/healthحالة صحة الخدمة
GET
/api/v1/downloadsسرد التنزيلات النشطة
GET
/api/v1/extractionsسرد الاستخراجات النشطة
GET
/api/v1/journalالاستعلام عن سجل تغييرات الملفات
الرئيسية / Kit / الملفات / مصفوفة الخلفيات
أنواع الخلفيات

كل فئة خلفية

أربع فئات تخزين، واجهة HTTP واحدة. حمّل أي مزيج وصل إليها جميعاً عبر نفس نمط URL.

الفئة
المزودون
نوع التحميل
طريقة المصادقة
التخزين السحابي
31 مزوداً منهم Google Drive وDropbox وOneDrive وBox
نظام ملفات افتراضي
OAuth / مفتاح API
تخزين الكائنات
S3 وAzure Blob وGCS وB2 وCloudflare R2 و25+ متوافق مع S3
مسار الدلو
IAM / مفتاح الوصول
بروتوكولات الملفات
FTP وSFTP وSMB وWebDAV وHTTP وHDFS
مسار شبكي
كلمة مرور / مفتاح / مجهول
خاص
ذاكرة تخزين مؤقت، تقطيع، دمج، تشفير، ضغط
طبقي
موروث من الخلفية المُلفَّفة
الرئيسية / Kit / الملفات / البدء

كل ملف هو عنوان URL

ابدأ القراءة والتحقق من الهاش وإدارة الملفات عبر 60+ مزوداً بواجهة HTTP واحدة. الملفات مدمجة في كل حاوية Hoody.

اقرأ التوثيق