إنشاء مجلد – واجهة برمجة تطبيقات Aspose.Cells السحابية
تشغيلة createFolder تقوم بإنشاء مجلد جديد في الموقع المحدّد ضمن مساحة التخزين السحابية المستخدمة من قِبل واجهة برمجة تطبيقات Excel. وتُعد هذه الوظيفة ضرورية لتنظيم الملفات وضمان هيكلية منظمة للمجلدات.
واجهة برمجة تطبيقات Excel: إنشاء مجلد
واجهة الويب (Web API)
PUT https://api.aspose.cloud/v4.0/cells/storage/folder/{path}
الأمان والمصادقة
تعمل واجهات برمجة تطبيقات Aspose.Cells السحابية بأمان وتتطلب مصادقة تعتمد على رمز JWT.
معلمات طلب واجهة createFolder
| اسم المعلمة | النوع | الموقع | الإلزام | القيمة المبدئية | الوصف |
|---|---|---|---|---|---|
path |
نص (String) | مسار (Path) | نعم | – | مسار المجلد المراد إنشاؤه (مثال: myFolder/subFolder). |
storageName |
نص (String) | استعلام (Query) | لا | – | اسم مساحة التخزين المراد استخدامها. إذا لم تُحدَّد، تُطبَّق مساحة التخزين الافتراضية. |
وصف الاستجابة
{}
تُعيد العملية محتوى فارغًا في حالة النجاح. وأكواد الحالة (HTTP Status Codes) الشائعة هي:
أكواد الحالة (HTTP Status Codes)
| كود 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
استخدام حزمة تطوير البرمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير، إذ تُدير هذه الحزم التفاصيل منخفضة المستوى وتسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة بحزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء استدعاءات إلى خدمات Aspose.Cells باستخدام حزم تطوير البرمجيات (SDKs) المختلفة: