تتيح واجهة برمجة تطبيقات copyFile للمستخدمين نسخ ملف إكسل من مسار مصدر محدّد إلى مسار وجهة، وتدعم خيارات تخزين متعددة.
واجهة برمجة تطبيقات إكسل: نسخ ملف
واجهة برمجة التطبيقات عبر الويب
PUT https://api.aspose.cloud/v4.0/cells/storage/file/copy/{srcPath}
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
معاملات الطلب لواجهة برمجة تطبيقات copyFile هي:
| اسم المعامل | النوع | المسار/سلسلة الاستعلام/جسم HTTP | الوصف |
|---|---|---|---|
| srcPath | String | Path | مسار الملف المصدر الذي سيُنسَخ. |
| destPath | String | Query | مسار الوجهة حيث سيتم حفظ الملف. |
| srcStorageName | String | Query | اسم وحدة التخزين المصدر. |
| destStorageName | String | Query | اسم وحدة التخزين الوجهة. |
| versionId | String | Query | معرّف الإصدار الاختياري للملف المراد نسخه. |
الاستجابة
لا تُعيد العملية أي محتوى في حال النجاح. رموز حالة HTTP الشائعة هي:
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مفوّض (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حملة البيانات كبيرة جدًا (Payload Too Large) | يتجاوز حجم الملف المرفوع الحدّ المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقّع في الخادم. |
كيفية استخدام واجهة برمجة تطبيقات نسخ الملف باستخدام مكتبات SDK؟
###仕様 واجهة برمجة تطبيقات نسخ الملف
يوفر 仕様 واجهة برمجة تطبيقات نسخ الملف واجهة برمجة تطبيقات مفتوحة للوصول عبر واجهة REST مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يوضح المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام مكتبات SDK هو أسرع طريقة لتطوير التطبيقات، حيث تُجرّدك من التفاصيل منخفضة المستوى، مما يسمح لك بتحويل بيانات جداول البيانات إلى صور برمجيات قليلة جدًا من الكود. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
توضّح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الويب باستخدام مكتبات SDK مختلفة: