ضغط البيانات في ملف إكسل – واجهة Aspose.Cells Cloud API
واجهة PostCompress API لخدمات الويب Aspose.Cells Cloud
المتطلبات الأساسية:
- مطلوب رمز JWT صالح للمصادقة.
- تنسيقات الملفات المدعومة هي: XLS و XLSX و XLSM و XLSB و ODS.
- أقصى حجم مسموح به للملف هو 500 ميغابايت لكل طلب (يخضع لقيود الخدمة).
تقوم هذه الواجهة REST بضغط بيانات ملف إكسل.
- ضغط ملفات XLS و XLSX و XLSM و XLSB و ODS
- ضغط سريع لعدة ملفات جداول بيانات إكسل
- اختيار مستوى الضغط
- دعم ملفات متعددة
نقطة نهاية واجهة الويب API
POST https://api.aspose.cloud/v3.0/cells/compress
الأمان والمصادقة
تُعد واجهات Aspose.Cells Cloud API آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مُعَيَّنات الطلب (Request Parameters)
| اسم المُعَيَّن | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| file | ملف | formData | الملف المراد رفعه |
| CompressLevel | عدد صحيح | query | مستوى الضغط (0–100)، وكلما زادت القيمة زادت قوة الضغط |
مُعَيَّن جسم الطلب (Request Body Parameter)
| اسم المُعَيَّن | النوع | الوصف |
|---|---|---|
| data | ملف | المحتوى الثنائي لملف المصنف المراد ضغطه. |
الاستجابة
{
"Status" : "OK",
"Code" : 200,
"Filename" : "[اسم الملف المدمج]",
"Filesize" : [حجم الملف],
"FileContent" : "[Base64String]"
}
ملاحظة: يحتوي FileContent على المصنف المضغوط مُشفَّرًا كسلسلة Base64. ويعكس طول السلسلة حجم الملف المضغوط؛ يمكنك فك التشفير باستخدام أدوات Base64 القياسية لاسترجاع ملف إكسل ثنائي.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (تم بنجاح) | تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | مُعَيَّنات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادَق | رمز JWT غير صالح أو مفقود. |
| 413 | حمل البيانات كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostCompress API مع SDKs
مواصفات واجهة PostCompress API
تُعرِّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، وتسمح بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات لواجهة Cloud API باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة لتسريع عملية التطوير. فتقوم SDK بإخفاء التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs متنوعة: