واجهة برمجة تطبيقات Aspose.Cells Cloud – الحصول على قائمة الملفات (محتويات المجلد)
تُعيد عملية الحصول على قائمة الملفات مجموعة الملفات والمجلدات الفرعية المخزَّنة في مجلد معيّن ضمن تخزين Aspose.Cells Cloud.
وهي نقطة الدخول الرئيسية لتصفح كتب عمل Excel المخزَّنة في السحابة، والملفات المؤرشفة، وأنواع الملفات الأخرى المدعومة.
واجهة برمجة تطبيقات Aspose.Cells Cloud – الحصول على قائمة الملفات (محتويات المجلد)
GET https://api.aspose.cloud/v4.0/cells/storage/folder/{path}
الأمان والمصادقة
تتميّز واجهات برمجة تطبيقات Aspose.Cells Cloud بالأمان وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| الاسم | الموقع | النوع | الإلزام | الوصف |
|---|---|---|---|---|
| path | المسار | سلسلة نصية | نعم | مسار المجلد في التخزين السحابي. |
| storageName | الاستعلام | سلسلة نصية | لا | اسم التخزين المراد استخدامه. إذا تُرك فارغًا، يُستخدم التخزين الافتراضي. |
| pageSize | الاستعلام | عدد صحيح | لا | الحد الأقصى لعدد العناصر المراد إعادتها لكل صفحة (الافتراضي: 100). |
| pageNumber | الاستعلام | عدد صحيح | لا | رقم الصفحة المراد استرجاعها (يبدأ من 1، الافتراضي: 1). |
- Value – مصفوفة من كائنات
StorageFile. يحتوي كل كائن على:Name– اسم الملف أو المجلد.IsFolder–trueإذا كان العنصر مجلدًا.Size– الحجم بالبايت (تُبلّغ المجلدات بالقيمة0).ModifiedDate– طابع الوقت الأخير للتعديل (بصيغة ISO 8601).
الاستجابة
رموز حالة HTTP
| رمز HTTP | حالة HTTP | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم استدعاء واجهة برمجة التطبيقات بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب خاطئ (Bad Request) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | ملف مُحمّل يتجاوز الحد الأقصى للحجم. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
مواصفات OpenAPI
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
يُعد استخدام SDKs أفضل طريقة لتسريع عملية التطوير. فالـ SDK يُدير التفاصيل منخفضة المستوى ويسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات ويب Aspose.Cells باستخدام SDKs متنوعة: