تُكرّر واجهة برمجة تطبيقات CopyFolder مجلدًا موجودًا داخل تخزين Aspose.Cells Cloud. وتُستخدم هذه الوظيفة عادةً لإنشاء نسخ احتياطية، أو إعادة تنظيم البيانات، أو إعداد هيكل المجلدات لمعالجة لاحقة دون الحاجة لنقل الملفات يدويًا.
واجهة برمجة تطبيقات إكسل: نسخ المجلد
واجهة برمجة التطبيقات عبر الويب
PUT https://api.aspose.cloud/v4.0/cells/storage/folder/copy/{srcPath}
الأمان والمصادقة
تتّسم واجهات برمجة تطبيقات Aspose.Cells Cloud بالأمان، وتشترط مصادقة مبنية على رمز JWT.
تقبل واجهة برمجة تطبيقات CopyFolder المعلَمات التالية:
| اسم المعلَمة | مطلوبة | النوع | الموقع (مسار/استعلام) | الوصف |
|---|---|---|---|---|
srcPath |
نعم | سلسلة | المسار | مسار المجلد المصدر الذي سيتم نسخه. |
destPath |
نعم | سلسلة | الاستعلام | المسار الذي سيتم إنشاء المجلد الجديد فيه. |
srcStorageName |
لا | سلسلة | الاستعلام | اسم التخزين الذي يحتوي على المجلد المصدر. |
destStorageName |
لا | سلسلة | الاستعلام | اسم التخزين الوجهة الذي يجب نسخ المجلد إليه. |
استجابة مثال
يعيد الاستدعاء الناجح رمز الحالة HTTP 200 مع جسم JSON فارغ:
{}
طلب مثال باستخدام cURL
curl -X PUT "https://api.aspose.cloud/v4.0/cells/storage/folder/copy/MyFolder?destPath=MyFolderCopy" \
-H "Authorization: Bearer {access_token}"
رموز حالات HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صحيح (Bad Request) | معلَمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
مواصفات OpenAPI
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك تنفيذ تفاعلات REST مباشرةً من خلال متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية إجراء استدعاءات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام واجهة برمجة التطبيقات (SDK) هو أفضل طريقة لتسريع عملية التطوير، إذ تعتني واجهة برمجة التطبيقات بتفاصيل المستوى المنخفض، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بواجهات برمجة تطبيقات (SDKs) الخاصة بـ Aspose.Cells Cloud.
توضّح أمثلة الكود التالية كيفية إجراء استدعاءات لخدمات الويب الخاصة بـ Aspose.Cells باستخدام مختلف واجهات برمجة التطبيقات (SDKs):