تصدير صفحة ورقة عمل – مرجع واجهة برمجة تطبيقات Aspose.Cells Cloud
يُعد تصدير صفحة ورقة عمل محددة مفيدًا عندما تحتاج إلى لقطة قابلة للطباعة لتقرير أو صورة مخطط أو استخراج بيانات دون تنزيل ملف العمل كاملاً. تتيح لك هذه النقطة النهائية استرجاع صفحة واحدة فقط بالتنسيق الأنسب لسير عملك اللاحق.
تتيح لك واجهة GET /cells/{name}/worksheets/{sheetName} تحويل صفحة محددة من ورقة العمل إلى تنسيقات ملفات متعددة. التنسيقات المدعومة: XLS، XLSX، XLSB، CSV، TSV، XLSM، ODS، TXT، PDF، OTS، XPS، DIF، PNG، JPEG، GIF، BMP، WMF، TIFF، EMF، NUMBERS، FODS.
واجهة برمجة التطبيقات REST
يُعرِّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة للعامة وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
المتطلبات المسبقة – يجب أن تمتلك رمز مصادقة JWT ساري المفعول وملف العمل المخزن في مجلد سحابي تحدده باستخدام المعامل
folder.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء استدعاء لواجهة برمجة التطبيقات السحابية باستخدام cURL.
المعاملات
| المعامل | النوع | الوصف | القيمة الافتراضية |
|---|---|---|---|
format |
نص (string) | تنسيق ملف الإخراج (مثل pdf، png، csv). |
pdf |
verticalResolution |
عدد صحيح (integer) | الدقة الرأسية للصورة المُرسَلة (DPI). | 100 |
horizontalResolution |
عدد صحيح (integer) | الدقة الأفقية للصورة المُرسَلة (DPI). | 100 |
pageIndex |
عدد صحيح (integer) | فهرس الصفحة (يبدأ من الصفر) لورقة العمل المراد تصديرها (0 = الصفحة الأولى). |
0 |
folder |
نص (string) | مجلد التخزين السحابي الذي يوجد فيه ملف العمل المصدر. | — |
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب خاطئ (Bad Request) | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
الأخطاء المحتملة
- 401 غير مصرّح (Unauthorized) – رمز JWT غير صالح أو مفقود.
- 404 غير موجود (Not Found) – ملف العمل أو ورقة العمل المحددة غير موجودة.
- 400 طلب خاطئ (Bad Request) – قيمة معامل غير صحيحة (مثل
formatغير مدعوم). - 500 خطأ داخلي في الخادم (Internal Server Error) – مشكلة غير متوقعة من جانب الخادم.
مجموعة أدوات التطوير (Cloud SDK Family)
استخدام SDK يُعد أفضل طريقة لتسريع عملية التطوير. فتتولى SDK إدارة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الويب باستخدام SDKs متنوعة: