تحويل ملف Excel إلى DOCX

يقوم هذا الـ REST API بتحويل ملف جدول بيانات إلى تنسيق ملف DOCX.

REST API

POST https://api.aspose.cloud/v3.0/cells/convert/docx

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

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

مُعاملات الاستعلام

اسم المُعامل النوع الوصف
password string كلمة المرور المطلوبة لفتح ملف Excel.
storageName string اسم وحدة التخزين التي يوجد فيها الملف.
checkExcelRestriction bool يشير إلى ما إذا كان سيتم التحقق من قيود ملف Excel عند قيام المستخدم بتعديل الكائنات المرتبطة بالخلية.

مُعامل جسم الطلب

اسم المُعامل النوع الوصف
datafile data file ملف البيانات المحفوظ في الجزء الأول من جسم الطلب متعدد الأجزاء.

الاستجابة

تعيد الواجهة كائن FileInfo يحتوي على ملف Word المُولّد.

الحقل النوع الوصف
Filename string اسم ملف Word (مثل example.docx).
FileSize int حجم الملف بالبايت.
FileContent string محتوى ملف Word المشفر بترميز Base64.

FileInfo

رموز حالة HTTP

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

كيفية استخدام واجهة PostConvertWorkbookToDocx API باستخدام SDKs

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

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

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

استخدام SDKs الخاصة بـ Aspose.Cells Cloud

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

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

واجهات برمجة تطبيقات أخرى تُنفّذ هذه الوظيفة

  • POST /cells/{name}/saveAs – تحفظ ملف Excel كملف DOCX مع إعدادات إضافية وتخزن النتيجة في وحدة التخزين المحددة.

  • PUT /cells/convert – تحول ملف Excel إلى ملف DOCX مع إعدادات اختيارية وترد بالنتيجة في الاستجابة.

  • GET /cells/{name} – تسترجع مصنف Excel وتحوله إلى ملف DOCX مع مُعاملات اختيارية.