الحصول على شكل باستخدام الفهرس في ورقة عمل إكسل – وثائق Aspose.Cells Cloud
تقوم هذه الواجهة البرمجية لـ REST باسترجاع شكل (بما في ذلك بيانات الصورة أو البيانات الوصفية الخاصة به) من ورقة عمل إكسل.
GetWorksheetShape API
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}
المتطلبات المسبقة
- رمز وصول صالح لـ Aspose Cloud (Bearer JWT).
- يجب أن يكون المصنف مخزنًا في مساحة التخزين الخاصة بـ Aspose Cloud أو في مجلد مُحدّد.
الأمان والمصادقة
تُعدّ واجهات برمجة التطبيقات (APIs) لـ Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مُعطَلات الطلب
| اسم المُعطَل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم مستند إكسل. |
| sheetName | string | path | اسم ورقة العمل التي يحتويها الشكل. |
| shapeindex | integer | path | الفهرس (الصفر-الأساسي) للشكل داخل ورقة العمل. |
| folder | string | query | مسار المجلد الذي يُخزّن فيه المستند. |
| storageName | string | query | اسم خدمة التخزين. |
ملاحظة: يكون shapeindex بصيغة صفر-الأساسية؛ أي أن أول شكل له الفهرس 0. تأكد من أن المصنف مخزن في folder وstorageName المحدّدين إن لم تستخدم مساحة التخزين الافتراضية.
يُعرّف مواصفة OpenAPI واجهة برمجة قابلة للوصول بشكل عام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء مكالمة لواجهة برمجة التطبيقات السحابية باستخدام cURL.
رموز حالة HTTP الممكنة
| الرمز | الوصف |
|---|---|
| 200 OK | تم استرجاع الشكل بنجاح. |
| 400 Bad Request | الطلب غير صحيح أو مفقود مُعطَلات مطلوبة. |
| 401 Unauthorized | فشلت المصادقة أو أن الرمز مفقود/غير صالح. |
| 404 Not Found | المصنف أو ورقة العمل أو فهرس الشكل المحدّد غير موجود. |
| 500 Internal Server Error | حدث خطأ غير متوقع في الخادم. |
المشكلات الشائعة: استخدام مجال أساسي خاطئ (api.aspose.com) أو الجزء القديم /autoshapes/ سيؤدي إلى خطأ 404. استخدم دائمًا الجزء /shapes/ مع المجال api.aspose.cloud.
مجموعة أدوات التطوير (SDK Family)
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. يتعامل SDK مع التفاصيل منخفضة المستوى ويسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الرمز التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة:
بالنسبة للعمليات ذات الصلة، راجع الوثائق الخاصة بـ إضافة شكل و تحديث شكل.