تحويل ملف إكسل متقدم – دليل واجهة Aspose.Cells Cloud API

واجهة برمجة تطبيقات سحابية متقدمة لتحويل إكسل

تتيح عملية التحويل المتقدمة (Advanced Convert) لك تحويل كتاب عمل إكسل إلى تنسيقات إخراج متنوعة (مثل PDF وHTML وCSV وما إلى ذلك)، مع منحك تحكمًا دقيقًا في إعدادات الصفحة، وخيارات الحفظ، وإعدادات الطباعة.

المتطلبات الأساسية / المصادقة
لاستخدام هذه النقطة النهائية (Endpoint)، يجب عليك الحصول على رمز وصول (access token) من Aspose.Cells Cloud وإدراجه في رأس الطلب Authorization كرمز نوع Bearer.

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

• الطريقة: PUT
• النقطة النهائية (Endpoint): /cells/convert
• المعاملات:
  • format (سلسلة نصية، مطلوبة) – تنسيق الإخراج المطلوب (مثل pdf أو html).
  • outPath (سلسلة نصية، اختيارية) – المسار في التخزين السحابي الذي سيتم حفظ الملف المحول فيه.
  • options (كائن، اختياري) – كائن JSON يحتوي على خيارات تحويل متقدمة مثل pageSetup وsaveOptions وprintSettings.
• مثال على جسم الطلب:

  {
    "format": "pdf",
    "outPath": "output/converted.pdf",
    "options": {
      "pageSetup": {
        "orientation": "Landscape",
        "paperSize": "A4"
      },
      "saveOptions": {
        "compress": true
      },
      "printSettings": {
        "printHeadings": false
      }
    }
  }
  

• الاستجابة:
  • 200 OK – تم التحويل بنجاح؛ تحتوي الاستجابة على تدفق الملف المحول أو مرجع للملف المحفوظ.
  • 400 Bad Request – معاملات غير صالحة أو جسم طلب معطّل.
  • 401 Unauthorized – فشلت المصادقة أو نقص رمز الوصول.
  • 500 Internal Server Error – خطأ في الخادم أثناء عملية التحويل.

رموز حالة HTTP

ملاحظات

• بعض تنسيقات الإخراج لها قيود محددة (مثل أن تحويل HTML لا يحتفظ بالماكروز). راجع الوثائق الخاصة بكل تنسيق للحصول على التفاصيل.

إمكانية تحميل ملفات جداول البيانات من مصادر بيانات متعددة

ضبط إعدادات الصفحة وخيارات الحفظ

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

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

توضح الأمثلة التالية كيفية إجراء مكالمات إلى خدمات الويب الخاصة بـ Aspose.Cells باستخدام حزم تطوير البرمجيات المختلفة: