Aspose.Cells Cloud – تحويل ملف Excel إلى PDF وCSV وHTML وما ب ذلك (GET /cells/{name})
تقوم هذه الـ API باسترجاع ملف Excel بتنسيق مختلف.
API GetWorkBook
GET https://api.aspose.cloud/v3.0/cells/{name}
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مُعَيَّنات الاستعلام (Query Parameters)
| اسم المُعَيَّن | النوع | الوصف | القيمة الافتراضية |
|---|---|---|---|
| format | string | تنسيق الملف الهدف (مثل: CSV وXLS وHTML وMHTML وODS وPDF وXML وTXT وTIFF وXLSB وXLSM وXLSX وXLTM وXLTX وXPS وPNG وJPG وGIF وEMF وBMP وMD وNumbers وWMF وSVG وما إلى ذلك). | – |
| password | string | كلمة المرور المطلوبة لفتح ملف Excel. | – |
| isAutoFit | bool | ضبط عرض الصفوف والأعمدة تلقائيًا. | false |
| onlySaveTable | bool | عند تعيينها على true، يتم حفظ بيانات الجدول فقط. تقبل القيمتين true أو false. |
false |
| outPath | string | المسار الذي سيتم حفظ النتيجة فيه. بالنسبة لملف واحد، تضمين اسم الملف وامتداده؛ بالنسبة لملفات متعددة، تحديد المجلد فقط. | – |
| outStorageName | string | اسم مخزن الملفات الذي سيتم حفظ ملف الإخراج فيه. | – |
| checkExcelRestriction | bool | التحقق من قيود Excel عند تعديل الخلايا أو الكائنات المرتبطة بها. | false |
| region | string | إعدادات المنطقة المطبّقة على ملف Excel. | – |
| pageWideFitOnPerSheet | bool | ضبط عرض الصفحة ليناسب كل ورقة عمل عند التحويل إلى PDF. | false |
| pageTallFitOnPerSheet | bool | ضبط ارتفاع الصفحة ليناسب كل ورقة عمل عند التحويل إلى PDF. | false |
| onePagePerSheet | bool | إنشاء صفحة PDF واحدة لكل ورقة عمل. | false |
| folder | string | مسار المجلد الذي يحتوي على ملف Excel الأصلي. | – |
| storageName | string | اسم مخزن الملفات الذي يوجد فيه الملف المصدر. | – |
الاستجابة
ناجح (200)
-
تُعيد الـ API كائن Workbook يحتوي على معلومات هيكل ملف Excel عند تجاهل مُعَيَّن الاستعلام
format. -
تُعيد الـ API الملف المحول بالتنسيق المطلوب عند تحديد نوع ملف في مُعَيَّن الاستعلام
format.
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456
(بيانات PDF ثنائية)
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | مُعَيَّنات مفقودة أو غير صالحة (مثل: تنسيق ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حمل البيانات كبير جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
ملاحظات:
- قد يستغرق تحويل ملفات Excel الكبيرة وقتًا أطول؛ يُوصى بزيادة مهلة الطلب.
- بعض التنسيقات (مثل
ODS) غير مدعومة لبعض ميزات Excel مثل الماكرو.
كيفية استخدام API GetWorkBook باستخدام SDKات
متطلبات مسبقة:
- رمز وصول JWT صالح تم الحصول عليه عبر عملية مصادقة Aspose.Cells Cloud.
- يجب تخزين ملف Excel المصدر في مخزن Aspose المدعوم أو تقديمه مباشرةً في الطلب.
- تأكد من أن إصدار الـ API (
v3.0) يطابق آخر إصدار صادر.
مواصفات API GetWorkBook
تُعرّف مواصفة OpenAPI واجهة برمجة تطبيقات عامة قابلة للاستخدام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
مثال على الطلب
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي طلب GET صحيح مع رأس المصادقة المطلوب.
استخدام SDKات Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة لتطوير البرمجيات. تُجرّدك SDKات من التفاصيل منخفضة المستوى لتركّز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKات Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر SDKات مختلفة:
انظر أيضًا
آخر تحديث: 2024-12-01