تحويل ملف إكسل إلى تنسيقات مختلفة
قبل استدعاء هذه النقطة النهائية (endpoint)، تأكد من حصولك على رمز JWT صالح، ومن وجود ملف المصنف المصدر في موقع تخزين مدعوم (مثل: Aspose Cloud Storage). ضع الرمز في رأس Authorization، وحدّد معلمة الاستعلام storageName إن لزم الأمر.
تقوم هذه الواجهة REST API بتحويل ملف إكسل إلى تنسيقات إخراج مختلفة.
PutConvertWorkBook API
PUT https://api.aspose.cloud/v3.0/cells/convert
يكون الطلب عبارة عن طلب HTTP PUT بمحتوى متعدد الأجزاء (انظر RFC 2046 أو RFC 1341).
يحتوي الجزء الأول من جسم الطلب متعدد الأجزاء على ملف البيانات، بينما يحتوي الجزء الثاني على خيارات الحفظ.
الأمان والمصادقة
تُعدّ واجهات Aspose.Cells Cloud API آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معلمات الاستعلام (Query Parameters)
| اسم المعلمة | النوع | الوصف |
|---|---|---|
format |
string | تنسيق ملف الإخراج المستهدف (مثل: CSV، XLS، HTML، PDF، XML، TXT، TIFF، PNG، JPG، GIF، EMF، BMP، MD، Numbers، WMF، SVG، إلخ). |
password |
string | كلمة المرور المطلوبة لفتح ملف الإكسل المصدر. |
outPath |
string | المسار الكامل (بما في ذلك اسم الملف وامتداده) لملف إخراج واحد، أو مسار مجلد عند توليد ملفات متعددة. |
storageName |
string | اسم مساحة التخزين التي يقع فيها ملف المصدر. |
checkExcelRestriction |
bool | عند القيمة true، يتحقق من قيود إكسل قبل تعديل الخلايا أو الكائنات المرتبطة بها. |
streamFormat |
string | تنسيق تدفق ملف الإدخال. |
region |
string | الإعدادات الإقليمية المطبّقة على مصنف العمل. |
pageWideFitOnPerSheet |
bool | ضبط عرض الصفحة لتناسب كل ورقة عمل عند التحويل إلى PDF. |
pageTallFitOnPerSheet |
bool | ضبط ارتفاع الصفحة لتناسب كل ورقة عمل عند التحويل إلى PDF. |
sheetName |
string | اسم ورقة العمل المراد تحويلها. |
pageIndex |
string | فهرس الصفحة المراد تحويلها (يتطلب sheetName). |
onePagePerSheet |
bool | عند القيمة true، يُولّد صفحة PDF واحدة لكل ورقة عمل. |
AutoRowsFit |
bool | ضبط ارتفاع جميع الصفوف في مصنف العمل تلقائيًا. |
AutoColumnsFit |
bool | ضبط عرض الأعمدة في مصنف العمل تلقائيًا. |
معلمات جسم الطلب (Request Body Parameters)
| اسم المعلمة | النوع | الوصف |
|---|---|---|
datafile |
data file | ملف الإكسل الموضّع في الجزء الأول من جسم الطلب متعدد الأجزاء. |
SaveOptions |
object | خيارات الحفظ الموضّحة في الجزء الثاني من جسم الطلب متعدد الأجزاء. |
الاستجابة
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
رموز حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معلمات مفقودة أو غير صحيحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام PutConvertWorkBook API مع واجهات برمجة التطبيقات SDK
مواصفات PutConvertWorkBook API
تُحدّد مواصفات OpenAPI واجهة قابلة للوصول بشكل عام تتيح التفاعل المباشر مع REST من متصفح ويب.
مثال باستخدام cURL
curl -X PUT "https://api.aspose.cloud/v3.0/cells/convert?format=html" \
-H "accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-d '{"File":{}}'
استخدام واجهات برمجة التطبيقات SDK لـ Aspose.Cells Cloud
استخدام واجهات SDK يُسرّع عملية التطوير من خلال التعامل مع التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على المنطق التجاري. راجع مستودع GitHub للحصول على قائمة كاملة بواجهات Aspose.Cells Cloud SDK.
تُظهر الأمثلة التالية كيفية استدعاء خدمات Aspose.Cells عبر واجهات SDK مختلفة: