حفظ ملف مصنف Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud

تتيح لك هذه واجهة برمجة التطبيقات حفظ ملف Excel بصيغ مختلفة.
قبل استدعاء هذه النقطة النهائية (endpoint)، تأكد من امتلاك رمز وصول OAuth 2.0 صالح، وأن ملف المصنف المصدر محفوظ في مساحة التخزين الخاصة بك في Aspose Cloud.

المتطلبات الأساسية

احصل على رمز وصول JWT وضمنه في رأس الطلب Authorization: Bearer <token> لكل طلب.
ارفع ملف المصنف المصدر إلى مساحة التخزين في Aspose Cloud (أو تأكد من وجوده مسبقًا).
اعرف اسم مساحة التخزين ومسار المجلد الذي يحتوي على ملف المصنف.

واجهة PostWorkbookSaveAs API

POST https://api.aspose.cloud/v3.0/cells/{name}/saveAs

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

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

معامل المسار (Path Parameter)

اسم المعامل	النوع	الوصف
name	string	اسم ملف Excel.

معامل الاستعلام (Query Parameter)

اسم المعامل	النوع	الوصف
newfilename	string	اسم الملف الجديد للمستند المحفوظ.
isAutoFitRows	string	إذا كان `true`، تُضبط ارتفاعات الصفوف تلقائيًا في المصنف. القيمة الافتراضية هي `false`.
isAutoFitColumns	string	إذا كان `true`، تُضبط عرض الأعمدة تلقائيًا في المصنف. القيمة الافتراضية هي `false`.
folder	string	المجلد الذي يحتوي على المصنف الأصلي.
storageName	string	اسم مساحة التخزين التي يوجد فيها ملف المصدر.
outStorageName	string	اسم مساحة التخزين التي سيتم حفظ ملف الإخراج فيها.
checkExcelRestriction	bool	يحدد ما إذا كان يجب تطبيق قيود Excel عند تعديل الخلايا أو الكائنات ذات الصلة.
region	string	الإعدادات الإقليمية المطبقة على المصنف.
pageWideFitOnPerSheet	bool	ضبط عرض الصفحة لتناسب كل ورقة عمل عند التحويل.
pageTallFitOnPerSheet	bool	ضبط ارتفاع الصفحة ليناسب كل ورقة عمل عند التحويل.
sheetName	string	اسم ورقة العمل المراد تحويلها.
pageIndex	string	فهرس الصفحة المراد تحويلها ضمن ورقة العمل المحددة (يتطلب `sheetName`).
onePagePerSheet	bool	عند التحويل إلى PDF، أنشئ صفحة واحدة لكل ورقة عمل.

معامل جسم الطلب (Request Body Parameter)

اسم المعامل	النوع	الوصف
SaveOptions	Object	خيارات الحفظ المقدمة في الجزء الثاني من الطلب متعدد الأجزاء.

مثال على جسم الطلب (الجزء JSON من الطلب متعدد الأجزاء)

{
  "SaveOptions": {
    "SaveFormat": "pdf",
    "CompressionLevel": 9
  }
}

الاستجابة

تعيد واجهة برمجة التطبيقات كائن SaveResponse.

{
  "Status": "OK",
  "Code": 200,
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  }
}

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK (نجاح)	تطبيق المرشح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب غير صالح)	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	Unauthorized (غير مصدق)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (حمولة كبيرة جدًا)	تجاوز حجم الملف المرفوع الحد المسموح به.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقع في الخادم.

كيفية استخدام واجهة PostWorkbookSaveAs API مع مكتبات SDK

مواصفات واجهة PostWorkbookSaveAs API

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

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

Request

curl -X POST "https://api.aspose.cloud/v3.0/cells/sampleBook.xlsx/SaveAs?newfilename=sample.pdf&isAutoFitRows=true&isAutoFitColumns=true" \
  -H "accept: multipart/form-data" \
  -H "Authorization: Bearer <your_jwt_token>"

Response

{
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

استخدام مكتبات Aspose.Cells Cloud SDK

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

تُظهر أمثلة الرمز التالية كيفية استدعاء خدمات Aspose.Cells باستخدام مكتبات SDK مختلفة:

للحصول على سيناريوهات تحويل أخرى، راجع الدليلين: تحويل ملف Excel إلى PDF و تصدير ملف Excel إلى CSV.

تحويل ملف إكسل إلى HTML تحويل ملف إكسل متقدم