تتيح لك واجهة REST هذه تصدير ورقة عمل من ملف Excel إلى العديد من تنسيقات الملفات المختلفة.
الملخص – استخدم نقطة النهاية Get Worksheet لتنزيل ورقة عمل واحدة من مصنف Excel بالتنسيق الذي تختاره.
يمكنك التصدير إلى التنسيقات التالية:
| التنسيق | الامتداد | نوع MIME |
|---|---|---|
| XLS | .xls | application/vnd.ms-excel |
| XLSX | .xlsx | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| XLSB | .xlsb | application/vnd.ms-excel.sheet.binary.macroEnabled.12 |
| CSV | .csv | text/csv |
| TSV | .tsv | text/tab-separated-values |
| XLSM | .xlsm | application/vnd.ms-excel.sheet.macroEnabled.12 |
| ODS | .ods | application/vnd.oasis.opendocument.spreadsheet |
| TXT | .txt | text/plain |
| application/pdf | ||
| OTS | .ots | application/vnd.oasis.opendocument.spreadsheet-template |
| XPS | .xps | application/vnd.ms-xpsdocument |
| DIF | .dif | application/x-dif |
| PNG | .png | image/png |
| JPEG | .jpeg | image/jpeg |
| GIF | .gif | image/gif |
| BMP | .bmp | image/bmp |
| WMF | .wmf | image/wmf |
| TIFF | .tiff | image/tiff |
| EMF | .emf | image/emf |
| NUMBERS | .numbers | application/vnd.apple.numbers |
| FODS | .fods | application/vnd.oasis.opendocument.spreadsheet-flat-xml |
الأمان والمصادقة
تعمل واجهات برمجة تطبيقات Aspose.Cells Cloud بشكل آمن وتتطلب مصادقة تعتمد على رمز JWT.
واجهة REST
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}
مُعلمات الطلب
| اسم المُعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | مطلوبة. اسم ملف Excel. |
| sheetName | string | path | مطلوبة. اسم ورقة العمل المراد تصديرها. |
| format | string | query | تنسيق ملف الوجهة لورقة العمل المُصدَّرة (مثل: pdf، png). |
| verticalResolution | integer | query | دقة الصورة بالـ DPI للتنسيقات التي تدعم الدقة (مثل: PNG، JPEG). |
| horizontalResolution | integer | query | دقة الصورة بالـ DPI للتنسيقات التي تدعم الدقة. |
| area | string | query | نطاق الخلايا المراد تصديره (مثل: A1:D10). |
| pageIndex | integer | query | مؤشر الصفحة المراد تصديرها عندما تكون ورقة العمل مقسّمة إلى صفحات. |
| folder | string | query | مسار المجلد في التخزين حيث يوجد الملف المصدر. |
| storageName | string | query | اسم تخزين Aspose Cloud. |
مواصفات OpenAPI تعرّف واجهة برمجة تطبيقات متاحة علنًا وتسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية استدعاء واجهة Cloud API باستخدام cURL.
معالجة الأخطاء
تردّ الواجهة على تنسيق رموز الحالة (HTTP status codes) القياسية. تشمل الردود الشائعة ما يلي:
| رمز الحالة | المعنى | مثال جسم JSON |
|---|---|---|
| 200 | نجاح – يتم إرجاع تدفق ورقة العمل. | { "stream": "..." } |
| 400 | طلب غير صحيح – مُعلمات مفقودة أو غير صالحة. | { "error": "Invalid format parameter." } |
| 401 | غير مصادق عليه – رمز JWT غير صالح أو مفقود. | { "error": "Authentication failed." } |
| 404 | غير موجود – الملف أو ورقة العمل المحددة غير موجودة. | { "error": "Worksheet not found." } |
| 500 | خطأ داخلي في الخادم – حالة غير متوقعة على الخادم. | { "error": "Unexpected error." } |
قم بمعالجة هذه الردود في كود العميل لتقديم ملاحظات مناسبة للمستخدمين.
عائلة SDK للسحابة
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. يتعامل SDK مع التفاصيل منخفضة المستوى ويسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات Aspose.Cells عبر الويب باستخدام SDKs مختلفة: