ضبط تكبير ورقة عمل Excel – واجهة Aspose.Cells Cloud API الإصدار 3.0

تقوم هذه الواجهة البرمجية REST بضبط قيمة التكبير لورقة عمل Excel. المصادقة مطلوبة؛ يُجبَر إرفاق رمز Bearer JWT صالح في رأس Authorization لكل طلب.

الأمان والمصادقة

واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

واجهة برمجة تطبيقات REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/zoom

مُعلمات الطلب

المعلمة	النوع	الموقع	الوصف
name	string	path	اسم ملف Excel (ورقة العمل).
sheetName	string	path	اسم ورقة العمل المراد تعديلها.
value	integer	query	نسبة التكبير بالمية (النطاق المسموح به 10–400، مثال: `40` تعني 40٪).
folder	string	query	مسار المجلد حيث يُخزَّن الملف.
storageName	string	query	اسم خدمة التخزين.

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول بشكل عام، وتمكّنك من إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء مكالمة لواجهة برمجة التطبيقات السحابية باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/zoom?value=40" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your_jwt_token>"

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

معلومات استجابة الأخطاء
تشمل رموز حالة HTTP المحتملة ما يلي:

400 Bad Request – معلمات مفقودة أو غير صالحة.
401 Unauthorized – رمز JWT مفقود أو غير صالح.
404 Not Found – الملف أو ورقة العمل المحددة غير موجودة.
500 Internal Server Error – خطأ غير متوقع من جانب الخادم.

تعيد كل استجابة خطأ جسم JSON يحتوي على Code وMessage وصفي.

عائلة حزم تطوير البرامج (SDKs) السحابية

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. تقوم SDK بالتعامل مع التفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرامج (SDKs) الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات Aspose.Cells باستخدام حزم تطوير البرامج (SDKs) المختلفة: