استرجاع مخطط من ورقة عمل – واجهة Aspose.Cells Cloud API
تقوم هذه الواجهة REST باسترجاع معلومات المخطط.
المتطلبات المسبقة – لاستدعاء هذه النقطة النهائية، يجب أن تمتلك حسابًا صالحًا على Aspose.Cells Cloud، وموقع تخزين نشط، ورمز وصول JWT. احصل على الرمز المميز اتباعًا للتعليمات في دليل المصادقة قبل إجراء أي طلبات API.
واجهة GetWorksheetChart
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartNumber}
الأمان والمصادقة
واجهات Aspose.Cells Cloud آمنة وتشترط مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel. |
| sheetName | string | path | اسم ورقة العمل التي يحتوي المخطط عليها. |
| chartNumber | integer | path | المؤشر المبدئي (صفر-الأساس) للمخطط المراد استرجاعه. |
| format | string | query | تنسيق التصدير المطلوب (مثل: png، jpeg). |
| folder | string | query | مسار المجلد حيث يتم تخزين المستند. |
| storageName | string | query | اسم خدمة التخزين. |
الاستجابة
{
"Code": 200,
"Status": "OK",
"Chart": {
"Name": "Chart 1",
"Type": "Bar",
"Top": 50,
"Left": 100,
"Width": 400,
"Height": 300,
"DataRange": "A1:B5",
"ShowLegend": true,
"Format": "png"
}
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حملة كبيرة جدًا (Payload Too Large) | ملف مُرفع يتجاوز الحد الأقصى للحجم. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة GetWorksheetChart مع حزم تطوير البرمجيات (SDKs)
مواصفات واجهة GetWorksheetChart
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، وتسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات إلى واجهة Cloud API باستخدام cURL.
استخدام حزم تطوير البرمجيات Aspose.Cells Cloud
استخدام حزمة تطوير البرمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير. تتعامل SDK مع التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام SDKs مختلفة: