Cloudix API
تتيح لك خدمة Cloudix API دمج تخزين الملفات السحابي عبر العقد الموزعة في أي تطبيق أو موقع، مع دعم كامل لجميع أنواع الملفات والأحجام الكبيرة.
https://cloudix.arix.live/api/v1
المصادقة (Authentication)
جميع الطلبات تتطلب إرسال مفتاح الـ API عبر الـ Header الخاص بالطلب. يمكنك إنشاء مفاتيح من لوحة المطورين.
قائمة الملفات
استعراض جميع الملفات المرفوعة على حسابك مع إمكانية التصفح عبر الصفحات.
$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']);
رفع ملف
رفع الملفات بأي حجم إلى خوادم Cloudix. يستخدم الطلب صيغة
multipart/form-data.
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'];
حذف ملف
حذف ملف من الخادم نهائياً باستخدام المعرف الفريد الخاص به والذي يتم توليده عند رفعه (اسم الملف).
$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";
أكواد الخطأ (Error Codes)
تستخدم الـ API كودات HTTP القياسية للإشارة إلى نجاح الطلب أو فشله. إذا كان
20x فالعملية ناجحة، وإذا كان 40x أو 50x فقد حدث خطأ.
الأسئلة الشائعة
بعض المشاكل والأسئلة الشائعة التي تواجه المطورين عند عملية دمج الـ API.
X-Api-Key الخاص بك، نمنع إرسال طلبات الرفع
والتحكم مباشرة من الـ Frontend.
الواجب عليك إنشاء Background API Endpoint في سيرفرك الخاص، ليقوم بالواسطة والاتصال
بنا لتجنب سرقة مفتاحك.
CURLFile في PHP.