استيراد البيانات دون استخدام التخزين – واجهة برمجة تطبيقات Aspose.Cells Cloud
يمكن أن يكون استيراد بيانات Excel معقدًا نظرًا لتأثير العديد من العوامل على النتيجة. ويجب أخذ جميع هذه العوامل بعين الاعتبار أثناء عملية الاستيراد. وتُبسّط Aspose.Cells Cloud عملية استيراد تنسيقات وأنواع بيانات متنوعة إلى ملف Excel بجودة احترافية.
تقوم هذه الواجهة البرمجية REST باستيراد البيانات إلى ملف Excel.
واجهة PostImportData API
POST https://api.aspose.cloud/v3.0/cells/import
الأمان والمصادقة
تعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
مُعلّمات الطلب:
| اسم المعلّمة | النوع | الموقع | الوصف |
|---|---|---|---|
| file | ملف | formData | ملف Excel المرفوع. |
| ImportOption | ImportOption | جسم JSON | كائن JSON يُعرّف البيانات المراد استيرادها، ونوعها (مثل IntArray أو DoubleArray أو StringArray)، وموقعها داخل ورقة العمل. |
تُوصَف مُعلّمات ImportOption في مرجع خيار استيراد البيانات /cells/import/#import-data-option-parameter.
المتطلبات المسبقة:
يجب إنشاء رمز JWT صالح مسبقًا، ولا يجوز أن يتجاوز حجم الملف الحد الأقصى للخدمة (عادةً 100 ميغابايت). وتشمل تنسيقات الملفات المدعومة XLS وXLSX وCSV وODS. وتأكد من تثبيت SDK المناسب إذا كنت تفضّل الوصول البرمجي.
الاستجابة
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق العامل بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | مُعلّمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حمل البيانات كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
ملاحظات:
عند إرسال الطلب، يتم تعيين رأس Content-Type: multipart/form-data تلقائيًا بواسطة العلامة -F. وللحملات الكبيرة، فكّر في ضغط البيانات قبل الاستيراد وتطبيق منطق إعادة المحاولة للأخطاء المؤقتة.
كيفية استخدام واجهة PostImportData API باستخدام حزم تطوير البرامج (SDKs)
###仕様 واجهة PostImportData API
يُعرّف 仕様 OpenAPI واجهة برمجة تطبيقات متاحة علنًا ويسمح لك بإجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب Aspose.Cells. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة تطبيقات السحابة باستخدام cURL.
استخدام حزم تطوير البرامج (SDKs) الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولّى SDK تفاصيل المستوى المنخفض وتتيح لك التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم SDK الخاصة بـ Aspose.Cells Cloud.
تُظهر الأمثلة التالية كيفية استدعاء خدمات الويب Aspose.Cells باستخدام SDKs مختلفة: