تحويل ورقة عمل إلى PDF و PNG و CSV وأكثر – واجهة برمجة تطبيقات Aspose.Cells Cloud
Contents
[
Hide
]
واجهة برمجة تطبيقات تحويل ورقة العمل – نقطة النهاية GET /cells/{name}/worksheets/{sheetName} تحوّل ورقة عمل واحدة (ورقة داخل ملف Excel) إلى نوع ملف آخر.
الشرط المسبق: يجب أن يكون لديك رمز JWT صالح وملف العمل مخزنًا في موقع مخزون Aspose Cloud المدعوم قبل استدعاء نقطة النهاية هذه.
الصيغ المُدخَلة المدعومة (يمكن قراءة ورقة العمل منها):
- XLS، XLSX، XLSB، CSV، TSV، XLSM، ODS، TXT
الصيغ المُخرَجة فقط المدعومة (يمكن حفظ ورقة العمل بها):
- PDF، OTS، XPS، DIF، PNG، JPEG، BMP، SVG، TIFF، EMF، NUMBERS، FODS
واجهة برمجة التطبيقات REST
تُوضّح مواصفات OpenAPI الواجهة المتاحة علنًا.
معطيات الطلب
| المعطى | النوع | الإلزام | القيمة الافتراضية | القيم المسموح بها | الوصف |
|---|---|---|---|---|---|
| format | string | نعم | – | pdf، png، jpeg، bmp، svg، tiff، emf، csv، txt، … (انظر القائمة المدعومة) | صيغة الإخراج الهدف. |
| verticalResolution | integer | لا | 96 | 72‑600 | الدقة العمودية للإخراج الصور. |
| horizontalResolution | integer | لا | 96 | 72‑600 | الدقة الأفقية للإخراج الصور. |
| password | string | لا | – | – | كلمة المرور لفتح ملف عمل محمي. |
| folder | string | لا | – | – | مجلد السحابة حيث يتم تخزين ملف العمل المصدر. |
| storage | string | لا | – | – | اسم المخزن (مثلًا “Default”). |
الاستجابة
| رمز الحالة | الوصف | نوع الإرجاع |
|---|---|---|
| 200 | نجح التحويل؛ يُعاد تيار ثنائي للملف المحول. | application/octet-stream |
| 400 | طلب غير صالح – معطيات مفقودة أو غير صالحة. | كائن خطأ JSON |
| 401 | غير مصرّح به – رمز JWT غير صالح أو مفقود. | كائن خطأ JSON |
| 404 | غير موجود – ملف العمل أو ورقة العمل غير موجود. | كائن خطأ JSON |
| 500 | خطأ داخلي في الخادم – فشل غير متوقع. | كائن خطأ JSON |
مثال على الطلب (cURL)
curl -v "https://api.aspose.com/v3.0/cells/myWorkbook.xlsx/worksheets/Sheet1?format=png&verticalResolution=96&horizontalResolution=96" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
مثال على الاستجابة
الصورة المحولة (تيار ثنائي)
عائلة SDK للحوسبة السحابية
استخدام SDK هو أسرع طريقة للتطوير. يُدار تفاصيل المستوى المنخفض تلقائيًا، ما يسمح لك بالتركيز على مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: