Excel إلى PNG
تقوم هذه الواجهة البرمجية (REST API) بتحويل ملف جدول بيانات إلى تنسيق PNG.
مواصفات واجهة برمجة التطبيقات (REST API)
POST https://api.aspose.cloud/v3.0/cells/convert/png
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معامل الاستعلام (Query Parameter)
| اسم المعامل | النوع | الوصف |
|---|---|---|
| password | string | كلمة المرور المطلوبة لفتح ملف Excel. |
| storageName | string | اسم وحدة التخزين التي يقع فيها الملف. |
| checkExcelRestriction | bool | يحدّد ما إذا كان سيتم التحقق من قيود ملف Excel عند تعديل الخلايا أو الكائنات ذات الصلة. |
معامل جسم الطلب (Request Body Parameter)
| اسم المعامل | النوع | الوصف |
|---|---|---|
| datafile | data file | ملف جدول البيانات المُضمَّن في الجزء الأول من الطلب المتعدد الأجزاء (multipart request). |
الاستجابة
تُعيد الواجهة البرمجية كائن FileInfo يحتوي على ملف PNG المُولّد.
| الحقل | النوع | الوصف |
|---|---|---|
| Filename | string | اسم ملف PNG (مثل example.png). |
| FileSize | int | حجم الملف بالبايت. |
| FileContent | string | محتوى ملف PNG المُشفّر بتشفير Base64. |
رموز حالات HTTP (HTTP Status Codes)
| الرمز | الدلالة | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصرّح (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًّا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقّع في الخادم. |
كيفية استخدام PostConvertWorkbookToPNG API باستخدام حزم تطوير البرمجيات (SDKs)
مواصفات PostConvertWorkbookToPNG API
يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة يمكن الوصول إليها، ويتيح لك إجراء تفاعلات REST مباشرةً من متصفّح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إرسال طلبات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام حزم تطوير البرمجيات (SDKs) الخاصة بـ Aspose.Cells Cloud
استخدام حزمة تطوير البرمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير. وتتولّى حزمة تطوير البرمجيات إدارة التفاصيل من المستوى المنخفض، بحيث تتمكن من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام حزم تطوير البرمجيات المختلفة:
واجهات برمجة تطبيقات أخرى تُ实施 نفس الوظائف
- POST /cells/{name}/saveAs – تحفظ ملف Excel كملف CSV (أو صيغ أخرى) مع إعدادات إضافية وتخزّن النتيجة.
- PUT /cells/convert – تحول ملف Excel إلى CSV (أو صيغ أخرى) باستخدام معاملات اختيارية وترجع النتيجة في الاستجابة.
- GET /cells/{name} – تسترجع ملف Excel وتحوله إلى CSV (أو صيغ أخرى) أثناء التنقّل (on the fly).