ابدأ الآن

Cloudix API

تتيح لك خدمة Cloudix API دمج تخزين الملفات السحابي عبر العقد الموزعة في أي تطبيق أو موقع، مع دعم كامل لجميع أنواع الملفات والأحجام الكبيرة.

Base URL https://cloudix.arix.live/api/v1
Security

المصادقة (Authentication)

جميع الطلبات تتطلب إرسال مفتاح الـ API عبر الـ Header الخاص بالطلب. يمكنك إنشاء مفاتيح من لوحة المطورين.

Header X-Api-Key: YOUR_API_KEY

Files API

قائمة الملفات

استعراض جميع الملفات المرفوعة على حسابك مع إمكانية التصفح عبر الصفحات.

GET /files
page optional integer
رقم الصفحة المطلوبة. الافتراضي: 1
limit optional integer
عدد النتائج لكل صفحة (الحد الأقصى 100). الافتراضي: 20
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://cloudix.arix.live/api/v1/files?page=1&limit=20',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: YOUR_API_KEY'],
]);
$response = json_decode(curl_exec($ch), true);
print_r($response['data']);
Files API

رفع ملف

رفع الملفات بأي حجم إلى خوادم Cloudix. يستخدم الطلب صيغة multipart/form-data.

POST /upload
file required binary
الملف المراد رفعه كـ multipart field. يُمنع رفع الملفات القابلة للتنفيذ مثل (php, js).
expiry optional string
مدة الصلاحية: 1d, 7d, 30d, 365d, أو never
$ch = curl_init('https://cloudix.arix.live/api/upload');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('/path/local_video.mp4'),
        'expiry' => '30d'
    ],
    CURLOPT_HTTPHEADER => ['X-Api-Key: YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);
echo "File URL: " . $response['url'];
Files API

حذف ملف

حذف ملف من الخادم نهائياً باستخدام المعرف الفريد الخاص به والذي يتم توليده عند رفعه (اسم الملف).

DELETE /files/{filename}
$filename = 'your_file_id.mp4';
$ch = curl_init('https://cloudix.arix.live/api/v1/files/' . $filename);
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => ['X-Api-Key: YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
echo "Deleted successfully";

Reference

أكواد الخطأ (Error Codes)

تستخدم الـ API كودات HTTP القياسية للإشارة إلى نجاح الطلب أو فشله. إذا كان 20x فالعملية ناجحة، وإذا كان 40x أو 50x فقد حدث خطأ.

200 / 201
تمت العملية بنجاح! لا توجد مشاكل.
401
مفتاح الـ API مفقود أو غير صالح. تأكد من إرساله في الهيدر بشكل صحيح.
403
ليس لديك صلاحية الوصول إلى هذا المورد.
404
الملف أو المسار المطلوب غير موجود.
413
حجم الملف تجاوز الحد الأقصى المسموح به في خطتك لحجم الملف أو استهلاك المساحة اليومي.
429
تجاوزت الحد المسموح للطلبات (Rate limit exceeded). يرجى تقليل سرعة الطلبات.
500
خطأ داخلي في الخادم. يرجى المحاولة لاحقاً.
Help & Support

الأسئلة الشائعة

بعض المشاكل والأسئلة الشائعة التي تواجه المطورين عند عملية دمج الـ API.

المقاطع والملفات المرفوعة يتم نقلها تلقائياً إلى العقد اللامركزية الموزعة مشفرةً. رابط الوصول العشوائي يحجب التخمين ومحكم لضمان أقصى درجات الخصوصية.
لأسباب أمنية ولحماية مفتاح X-Api-Key الخاص بك، نمنع إرسال طلبات الرفع والتحكم مباشرة من الـ Frontend. الواجب عليك إنشاء Background API Endpoint في سيرفرك الخاص، ليقوم بالواسطة والاتصال بنا لتجنب سرقة مفتاحك.
تأكد في الكود الخاص بك أنك تقوم بقراءة الملف كتيار من البيانات الثنائية (Binary Stream). تأكد من عدم قراءته بصيغة نصية للصور والفيديوهات. استخدم CURLFile في PHP.