تصدير كائن OLE – واجهة برمجة تطبيقات Aspose.Cells السحابية

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

POST https://api.aspose.cloud/v3.0/cells/export

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

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

معلمات الطلب

المعلمة الموقع النوع مطلوبة الوصف
file بيانات النموذج (Form‑data) ملف نعم ملف Excel (.xlsx, .xls, إلخ) الذي يحتوي على كائنات OLE.
outputFormat استعلام (Query) نص (string) نعم التنسيق المستهدف للكائنات المصدرَة (pdf, png, jpeg, docx, pptx).
objectType استعلام (Query) نص (string) نعم القيمة الثابتة oleobject.

الاستجابة

يُعيد الطلب الناجح كائن JSON يسرد الملفات المصدرَة:

{
  "Files": [
    {
      "Filename": "OLESlide.ppt",
      "FileSize": 390,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "OLEDoc.docx",
      "FileSize": 382,
      "FileContent": "-----Base64String--------"
    }
  ]
}

رموز حالة HTTP

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

كيفية استخدام واجهة PostExport API مع حزم تطوير البرامج (SDKs)

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

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

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

curl -X POST "https://api.aspose.cloud/v3.0/cells/export?objectType=oleobject&format=pdf" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -F "file=@MyWorkbook.xlsx" \
  -F "outputFormat=pdf"

ما هو كائن OLE؟

كائن OLE (Object Linking and Embedding) يُضمّن محتوى خارجيًا — مثل مستندات Word أو شرائح PowerPoint أو الصور أو ملفات أخرى — داخل ملف Excel. عند التصدير، يتم استخراج المحتوى المُضمّن وحفظه بالتنسيق المطلوب.

نظرة عامة على نقطة النهاية (Endpoint)

POST https://api.aspose.cloud/v3.0/cells/export?objectType=oleobject&format={outputFormat}

  • objectType – يجب أن تُعيَّن على oleobject.
  • format – التنسيق المستهدف للإخراج (مثل pdf, png, jpeg, docx, pptx).

استخدام حزم تطوير البرامج (SDKs) الخاصة بـ Aspose.Cells Cloud

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

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

استيراد صورة إلى ورقة عمل Excel استيراد مصفوفة أعداد صحيحة إلى ورقة عمل إكسل