تقوم هذه الواجهة البرمجية REST باستيراد البيانات إلى ملف Excel.
واجهة PostImportData API
POST https://api.aspose.cloud/v3.0/cells/{name}/importdata
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud أمانًا وتتطلب مصادقة مبنية على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | سلسلة نصية | المسار | اسم ملف Excel. |
| folder | سلسلة نصية | استعلام | مسار المجلد في التخزين حيث يوجد الملف. |
| storageName | سلسلة نصية | استعلام | اسم خدمة التخزين. |
| importData | كائن | الجسم | كائن JSON يحتوي على البيانات المراد استيرادها. |
تُوضّح معاملات خيارات استيراد البيانات في رابط المرجع.
المتطلبات الأساسية: يجب توفير رمز JWT صالح في رأس Authorization، وضمان وجود المصنف المستهدف مسبقًا في موقع التخزين المحدد.
الاستجابة
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق العامل بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حمل البيانات كبير جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | حدوث خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostImportData API باستخدام SDKs
مواصفات واجهة PostImportData API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتسمح بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يُظهر المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs لـ Aspose.Cells Cloud
استخدام SDKs يُعد أفضل طريقة لتسريع عملية التطوير، حيث تُجرّد SDKs التفاصيل من المستوى المنخفض، مما يسمح لك بالتركيز على منطق أعمالك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
يُظهر مثال الكود التالي كيفية استدعاء خدمة ويب Aspose.Cells باستخدام SDK بلغة PHP: