واجهة برمجة تطبيقات Aspose.Cells Cloud – استرجاع صورة من ورقة عمل
تقوم هذه الواجهة البرمجية (REST API) باسترجاع صورة باستخدام فهرسها المُعدّ من الصفر من ورقة عمل Excel.
واجهة برمجة التطبيقات REST
لاستدعاء هذه النقطة النهائية، يجب أن تتضمّن رأس Authorization رمز وصول JWT صالح. ويُحصل على الرموز عبر عملية مصادقة Aspose.Cells Cloud، وتحتاج إلى النطاقات (scopes) المناسبة للوصول إلى الملفات. وللمزيد من التفاصيل حول كيفية الحصول على رمز وصول، راجع الدليل العام المعنون Authentication (المصادقة).
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/{pictureIndex}
المعاملات المطلوبة في الطلب
| اسم المعاملة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel. |
| sheetName | string | path | اسم ورقة العمل. |
| pictureIndex | integer | path | فهرس الصورة (يبدأ من الصفر). |
| format | string | query | تنسيق التصدير المطلوب (مثل: png، jpg، bmp، gif، tiff). وإذا تُركت بدون تحديد، تُعاد الصورة بتنسيقها الأصلي. |
| folder | string | query | المجلد الذي يحتوي على المستند. |
| storageName | string | query | اسم موقع التخزين. |
استجابات الأخطاء
| الرمز HTTP | الوصف |
|---|---|
| 401 | غير مُصادَق – رمز وصول مفقود أو غير صالح. |
| 404 | غير موجود – الملف أو ورقة العمل أو فهرس فاصل الصفحات المحدّد غير موجود. |
| 400 | طلب خاطئ – صيغة الطلب غير سليمة أو المعاملات غير صالحة. |
| 500 | خطأ داخلي في الخادم – وُجدت حالة غير متوقعة. |
يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للاستخدام، ويسمح لك بإجراء تفاعلات REST مباشرة من متصفّح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يوضح المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL.
عائلة SDK للسحابة
استخدام SDK هو أسرع طريقة لتطوير البرمجيات. فSDK تتعامل مع التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مشروعك. يُرجى زيارة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الإنترنت باستخدام SDKs متنوعة: