تحويل ملف Excel إلى PDF – واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم هذه واجهة برمجة تطبيقات REST بتحويل ملف جدول بيانات إلى ملف بصيغة PDF. المتطلبات المسبقة: احصل على رمز وصول JWT صالح، وتأكد من أن ملف Excel المصدر مخزن في مساحة تخزين مدعومة، وامتلك الصلاحيات المناسبة لاستدعاء نقطة نهاية التحويل.
واجهة برمجة تطبيقات PostConvertWorkbookToPDF
POST https://api.aspose.cloud/v3.0/cells/convert/pdf
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معامل الاستعلام
| اسم المعامل | النوع | الوصف |
|---|---|---|
| password | string | كلمة المرور لفتح ملف Excel. |
| storageName | string | اسم مساحة التخزين التي يُخزّن فيها الملف. |
| checkExcelRestriction | bool | ما إذا كان سيتم تطبيق قيود ملف Excel عند تعديل الكائنات المرتبطة بالخلايا. |
يُفترض أن تكون قيمة checkExcelRestriction تساوي false في حال حُذف هذا المعامل.
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
| datafile | file | ملف البيانات المُحفوظ كالجزء الأول لمحتوى متعدد الأجزاء. |
الاستجابة
ترجع الاستجابة كائن JSON يحتوي على بيانات تعريف الملف. يمكن تنزيل ملف PDF نفسه باستخدام FileContent (المُشفّر بترميز base64) أو عبر الرابط الموجود في FileInfo. تُرجع واجهة برمجة التطبيقات كائن JSON من النوع FileInfo:
- FileInfo – كائن يحتوي على اسم وحجم ومحتوى مشفّر بترميز base64 لملف PDF المُولّد.
{
"Filename": "example.pdf",
"FileSize": 12345,
"FileContent": "base64_encoded_string"
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تمت عملية التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مخوّل (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حملة الطلب كبيرة جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة برمجة تطبيقات PostConvertWorkbookToPDF باستخدام حزم تطوير البرمجيات (SDKs)
مواصفات واجهة برمجة تطبيقات PostConvertWorkbookToPDF
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
رؤوس الطلب
| الرأس | النوع | الوصف |
|---|---|---|
| Authorization | string | رمزBearer تم الحصول عليه عبر المصادقة باستخدام JWT. |
| Content-Type | string | يجب أن تكون قيمته multipart/form-data لرفع الملفات. |
| Accept | string | application/json لتلقي بيانات تعريف الاستجابة. |
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. ضع رمز الوصول في رأس Authorization، ثم نفّذ الطلب التالي:
استخدام حزم تطوير البرمجيات (SDKs) الخاصة بـ Aspose.Cells Cloud
قد يبسّط استخدام SDK تطوير البرمجيات من خلال التعامل مع التفاصيل منخفضة المستوى. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات (SDKs) الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة التعليمات البرمجية التالية كيفية إجراء مكالمات إلى خدمات Aspose.Cells عبر SDKs متنوعة:
واجهات برمجة تطبيقات أخرى تنفّذ هذه الوظيفة
| واجهة برمجة التطبيقات | النوع | الوصف | رابط Swagger |
|---|---|---|---|
| /cells/convert | PUT | تحويل كتاب عمل من محتوى الطلب إلى تنسيق محدّد. | PutConvertWorkBook |
واجهة برمجة تطبيقات POST /cells/{name}/saveAs تتيح لك حفظ ملف Microsoft Excel بصيغة PDF مع إمكانية ضبط إعدادات إضافية وتخزين النتيجة في مساحة التخزين.
تقوم هذه واجهة برمجة تطبيقات REST بتحويل ملف Excel إلى PDF.
واجهة برمجة تطبيقات PUT /cells/convert تتيح لك تحويل ملف Microsoft Excel إلى PDF مع إمكانية ضبط إعدادات إضافية وإعادة النتيجة في الاستجابة.
واجهة برمجة تطبيقات GET /cells/{name} تتيح لك تحويل ملف Microsoft Excel إلى PDF مع إمكانية ضبط إعدادات إضافية وإعادة النتيجة في الاستجابة.
تُعرّف واجهات برمجة التطبيقات PutConvertWorkBook، وGetWorkBook، وPostDocumentSaveAs واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
للحصول على خيارات تحويل إضافية، راجع صفحة خيارات الحفظ.